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INTRODUCTION 


Welcome. This guide explains how to convert audio and video into 
streaming or downloadable media using RealProducer 10 Powered 
by Helix” DNA. It teaches you how to create clips, or send a live 


stream to Helix Server for broadcast to RealPlayer viewers. 


How This Guide Is Organized 


The guide contains the following chapters and appendixes. 


Chapter 1: New Features 


This chapter explains new and removed features in RealProducer 10. 


Chapter 2: Media Basics 
If you are new to media production, refer to this chapter for explanations of 
media encoding options and the major features of RealProducer 10. 


Chapter 3: Installation 
This chapter explains RealProducer requirements and describes how to install 
the product. 


Chapter 4: Producing Audio 
For tips about producing high-quality audio content, refer to this chapter. 
This chapter also explains the properties of the various RealAudio codecs. 


Chapter 5: Producing Video 
The information in this chapter will help you to create high-quality video 
content. This chapter also explains the RealVideo codecs and filtering options. 


Chapter 6: Encoding Clips 
This chapter describes how to use the RealProducer graphical application to 
set up an encoding job. 
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Chapter 7: Choosing Audiences 
This chapter describes the settings of the predefined audiences that you use to 
set clip and broadcast streaming speeds. 


Chapter 8: Monitoring a Job 
When you are ready to start encoding, refer to this chapter for information 
about kicking off and monitoring the encoding process. 


Chapter 9: Modifying Default Settings 
For information about changing the RealProducer preferences and audience 
settings, see this chapter. 


Chapter 10: Planning a Broadcast 


This chapter explains the basic issues around broadcasting live audio or video. 


Chapter 11: Running a Broadcast 
When you are ready to set up a live broadcast, refer to this chapter for 
explanations of how to perform a push or pull broadcast. 


Chapter 12: Editing RealMedia Files 
This chapter explains how to use the RealMedia Editor to edit RealAudio and 
RealVideo clips. 


Chapter 13: Defining Events and Image Maps 
The RMEvents utility allows you to encode clip information, create clickable 
image maps, and open Web pages automatically as a clip plays. 


Chapter 14: Using the Command-Line Application 
Refer to this chapter if you plan to encode clips or broadcasts using the 
RealProducer command-line application. 


Appendix A: XML File Basics 


This appendix describes the basic rules for editing the RealProducer XML- 
based files. 


Appendix B: Job File Syntax 

Job files can define the encoding settings used by the graphical application 
and the command-line application. This appendix describes the job file 
syntax. 
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Appendix C: Audience File Syntax 
This appendix explains the syntax of audience files, which define the 
streaming speeds at which clips and broadcasts are encoded. 


Appendix D: Server File Syntax 
Server files define server destinations used in live broadcasts. This appendix 
describes the server file syntax. 


Appendix E: Preference File Syntax 
This appendix explains how to edit the RealProducer preferences file manually 
to set overall encoding preferences. 


Conventions Used in this Guide 
The following table explains the typographical conventions used in this guide. 


Notational Conventions 


Convention Meaning 

emphasis Bold text is used for in-line headings, user-interface 
elements, URLs, and e-mail addresses. 

terminology Italic text is used for technical terms being introduced, 
and to lend emphasis to generic English words or 
phrases. 

syntax This font is used for fragments or complete lines of 


programming syntax (markup). 


syntax emphasis | Bold syntax character formatting is used for program 
names, and to emphasize specific syntax elements. 


variables Italic syntax character formatting denotes variables 
within fragments or complete lines of syntax. 


options Square brackets indicate values that you may or may not 

q vy y y 
need to use. As a rule, when you use these optional values, 
you do not include the brackets themselves. 


choice 1|choice 2 | Vertical lines, or “pipes,” separate values that you can 
choose between. 


Ellipses indicate nonessential information omitted from 


examples. 
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Additional Documentation Resources 


In addition to this introductory guide, you may need the following resources, 
which are available for download at http://service.real.com/help/library/ 
encoders. html: 


+ Introduction to Streaming Media 


Start with this guide if you are new to streaming media or RealNetworks 
products. Written for the beginning user, it explains how to put together a 
basic presentation using different production techniques. 


« RealNetworks Production Guide 


This guide is the main reference manual for streaming media production. 
It expands on most of the topics presented in this introductory guide. 
Refer to it for instructions and tips on media production, as well as for 
complete information about using SMIL. 


+ RealPlayer Scripting Guide 


If you are a Web programmer, refer to this guide for instructions about 
using Javascript or VBScript with RealPlayer. Using these scripting 
languages, you can customize RealPlayer to turn it into your own Internet 
jukebox, for example. 


¢ Helix Server Administration Guide 


The basic reference for the Helix Server administrator, this guide explains 
how to set up, configure, and run Helix Server to stream multimedia. You 
need this guide only if you are running Helix Server yourself. It is available 
at http://service.real.com/help/library/servers.html. 


Technical Support 


To reach RealNetworks’ Technical Support, you can contact their Web site by 
choosing Help>Technical Support from the RealProducer main menu. The 
information you provide in this form will help Technical Support personnel 
respond promptly. For general information about RealNetworks' Technical 
Support, visit http://service.real.com. 


GETTING STARTED 


The following chapters introduce you to features new in 
RealProducer 10, as well as explain the basic issues for 
encoding a clip or broadcast. The installation chapter explains 
computer requirements, and walks you through the installation 


process. 


PART 


CHAPTER 


T 


NEW FEATURES 


This chapter describes new and removed features in RealProducer 
10. It also discusses upgrade issues if you have used an earlier 


version of RealProducer or Helix Producer. 


New Features in RealProducer 10 


RealProducer 10 succeeds Helix Producer as the primary tool for encoding 
RealMedia clips and live broadcasts. The following sections describe the new 
features introduced in RealProducer 10. 


RealVideo 10 


RealVideo 10 is the default video codec for RealProducer 10. It provides 
significant quality advances over its predecessors, RealVideo 9 and RealVideo 
8. Clips encoded with RealVideo 10 exhibit greater clarity and increased 
smoothness of motion, particularly in fast-action scenes. You can stream the 
RealVideo 10 format with RealServers version G2 through 8, as well as Helix 
Server. These servers do not require any plug-in updates to stream the new 
content. 


Tip: The RealProducer Plus command-line application 
includes a -vco option that allows you to override the video 
codec selected in the audience file. For details, refer to “Video 
Codec Override (-vco)” on page 273. 


For More Information: See “RealVideo 10 Codec” on page 60. 


RealAudio 10 Stereo Music Codecs 


RealProducer 10 introduces new codecs for stereo music and stereo surround 
based on AAC encoding technology. These codecs replace older codecs based 
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on ATRAC3 technology. Within the RealProducer graphical user interface, 
these codecs are designated as “RealAudio 10”. 


+ 96 Kbps Stereo Music - RealAudio 10 

+ 128 Kbps Stereo Music - RealAudio 10 

+ 160 Kbps Stereo Music - RealAudio 10 

+ 192 Kbps Stereo Music - RealAudio 10 

+ 256 Kbps Stereo Music - RealAudio 10 

+ 320 Kbps Stereo Music - RealAudio 10 

+ 128 Kbps Stereo Surround - RealAudio 10 
+ 160 Kbps Stereo Surround - RealAudio 10 
+ 192 Kbps Stereo Surround - RealAudio 10 
- 256 Kbps Stereo Surround - RealAudio 10 
+ 320 Kbps Stereo Surround - RealAudio 10 


Many audience templates that formerly used the ATRAC3 codecs use the new 
RealAudio 10 stereo codecs at the same bit rates. The new codecs can encode 
any input acceptable to RealProducer, and can use any audio prefilter. You can 
use the encoded output for clips or live broadcasts. Note, however, that the 
RealAudio 10 codecs are compatible only with RealOne Player (an automatic 
codec update is required) and RealPlayer 10. Listeners using older players are 
prompted to upgrade when they attempt to play the content. 


Note: Stereo music codecs that encode at rates below 96 Kbps 
are not based on AAC technology. They are backwards- 
compatible to RealPlayer G2 or RealPlayer 8, depending on the 
precise codec used. For more information, refer to “5.1 
Multichannel Audio Codecs” on page 43. 


RealAudio 5.1 Multichannel Codecs 


RealProducer 10 multichannel RealAudio codecs that enhance the Surround 
Audio technology found in RealAudio 8. These new codecs preserve the 
discrete, multichannel sound data in input files. The multichannel RealAudio 
codecs can use any audio data that includes 1, 2, 4, 5, and 6 channels, up- 
sampling the input as necessary to 6 channels. As found on DVDs, 
multichannel sound typically includes six discrete channels, commonly 
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referred to as 5.1 channels. RealProducer includes the following predefined 
audience templates that use multichannel RealAudio by default: 


+ 5.1 Multichannel 450 Kbps VBR Download 
+ 5.1 Multichannel 700 Kbps VBR Download 
+ 5.1 Multichannel 1 Mbps VBR Download 

- 5.1 Multichannel 1.5 Mbps VBR Download 


For More Information: See “5.1 Multichannel Audio Codecs” on 
page 43 for details about multichannel encoding. 


RealAudio Lossless Codec 


RealProducer 10 includes a lossless RealAudio codec that faithfully 
reproduces the full dynamic frequency of the input audio file while 
compressing the output. The encoded clip, which is saved in the RealMedia 
variable bit rate format (.rmvb), is typically around half the size of the input 
file, though the compression rate varies with different types of input. 


For More Information: See “Lossless Audio Codec” on page 45 
for complete information. 


Audio Delay Compensation Prefilter 


The audio delay compensation prefilter corrects audio shift when audio input 
is out of synchronization with a video’s visual track. You must specify the use 


of this filter manually through a job file. 


For More Information: See “Audio Delay Compensation 
Prefilter” on page 317. 


Video Resize Prefilter 


Using a job file, you can resize a video before or after other video filters are 
applied. This gives you the flexibility to resize the video at any point during 
the prefiltering process. 


For More Information: See “Video Resizing Methods” on page 
309. 
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Encoding Complexity 


RealProducer introduces encoding complexity modes of low, medium, and high 
that affect the RealVideo 9 and RealVideo 10 codecs, as well as the RealAudio 
lossless codec. The default value of high produces the best possible results, but 
also requires the most processing, resulting in the longest encoding times. 
Lowering the complexity level to medium or low results in faster encoding 
times, but reduced quality (for video) or a larger file size (for lossless audio). 


For More Information: See “Encoding Complexity Modes” on 
page 79. 


File Rolling for Large Clips 


Through the RealProducer command-line application or job file, you can 
create multiple RealMedia files for a single output clip. This allows you to 
overcome limitations on the size of a single file, which is typically 2 to 4 
Gigabytes, depending on the operating system. You can create a new output 
file based on the length of the encoding time, such as every 15 minutes, or on 
the size of the encoded file. 


For More Information: See “File Destinations” on page 320 for 
information about adding file rolling to a job file. The section 
“Output and Destination Options” on page 261 explains how 
to set up file rolling through the command-line application. 


Multiple Outputs for a Single Encoding Job 


Helix Producer 9 introduced the use of multiple destinations, which is the ability 
to write the same stream to more than one destination. This allows you to 
write to two separate files, for example, or to broadcast a stream to a server 


while simultaneously writing it to an archive file. 


RealProducer 10 introduces multiple outputs, which builds on the multiple 
destinations feature. Using multiple outputs, you can vary the encoding 
properties of the various destinations during a single encoding session. There 
are many uses for multiple outputs, such as the following: 


+ You can encode clips with different properties for different bandwidths. 
For example, from the same input you can encode a clip for low- 
bandwidth connections using a small frame size, and a separate clip for 
high-bandwidth connections using a large frame size. 
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+ You might broadcast a live stream at a relatively low bit rate to conserve 
bandwidth on your server. At the same time, you can archive the stream at 
a high bit rate to provide higher-quality, on-demand access to the event at 
a later point. 


For More Information: You can define multiple outputs through 
the job file. For more information, refer to “File and Server 
Outputs” on page 319. 


Enhanced Load Management Capabilities 


RealProducer 10 provides enhanced load management capabilities that help 

to ensure that encoding processes for live streams do not lag behind the live 

input due to CPU constraints. It provides detailed feedback about how it has 
reduced the broadcast stream quality to manage the encoding load. 


For More Information: See “Broadcast Load Management” on 
page 174. 


New Job File Format 


The syntax of the job file has changed to make the file more extensible and 
robust. The new job file format uses generic XML tag names for inputs, 
prefilters, outputs, postfilters, and streams. For example, in an older job file, 
the black-level prefilter section looked like the following: 


<blackLevelPrefilter> 
...prefilter information... 
</blackLevelPrefilter> 


In the new job file, the black level prefilter section looks like the following: 


<prefilter xsi:type="blackLevelPrefilter"> 
...prefilter information... 
</prefilter> 


For More Information: See also “Job File Versions” on page 13. 


Features Introduced in Version 9 


Version 9 of Helix Producer introduced the following features, which are 
included in RealProducer 10: 


+ New Graphic Interface—gives you a more usable workspace. 
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+ RealVideo 9 Encoding—allows you to create the high-quality video for any 
bit rate, especially at high-bandwidth rates. 


+ Encoding Jobs—allow you to save and share your encoding settings, such 
as sources used, destinations encoded to, and other settings. 


+ Multiple Destinations—send the encoded output to more than one Helix 


Server, or to a file and a server simultaneously. 


- Audience Templates—allow you to save and share information about your 
target audience, such as codec used, target bit rate, and target frame rate. 


+ Server Definition Templates—allow you to save and share information 
about setting up a Helix Server for live broadcasting. 


+ Enhanced Live Broadcasting—new broadcasting models, such as Push and 
Pull that allow you to better customize your Helix Server connection. 


+ Logging—allows you to track important events that occur during 
encoding. 


Features Removed from RealProducer 10 


The following features, included with previous versions of RealProducer and 
Helix Producer, have been removed from RealProducer 10. 


RealVideo G2 with SVT 


The RealVideo G2 codec has been removed from RealProducer. The RealVideo 
8 codec is the oldest codec available in RealProducer, providing playback 
compatible with RealPlayer 8 and later. 


ATRAC3-Based Music Codecs 


As described in “RealAudio 10 Stereo Music Codecs” on page 7, AAC-based 
codecs have replaced ATRAC3-based codecs for streaming bit rates above 96 
Kbps for stereo and stereo surround music. 


Upgrade Issues 


The following sections explain issues with upgrading to RealProducer 10 from 
an earlier version of Helix Producer. 
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New Installation Directory 
On Windows, RealProducer 10 installs by default in a new directory: 
c:\\Program Files\Real\RealProducer Plus 10 
—OR— 
c:\\Program Files\Real\RealProducer Basic 10 


RealProducer 10 does not overwrite previous installations of RealProducer or 
Helix Producer, and you can continue to use the older versions along with 
RealProducer 10. 


Job File Versions 


RealProducer 10 uses a new job file format. It reads older job files and saves 
them to the new format automatically. You can also update older job files as 
described in the section “Job File Syntax Update” on page 279. 
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CHAPTER 


MEDIA BASICS 


This chapter introduces you to the steps for creating streaming or 
downloadable media. It describes the major features of 
RealProducer, and explains the procedures for encoding and 


delivering static clips or live broadcasts. 


Inputs and Sources 


RealProducer encodes RealAudio and RealVideo clips and broadcasts from 
audio and video input. This input can be a file in a format such as WAVE, AVI, 
or MPEG. Or, the input may be live material that you have captured with a 
microphone or camera attached to an audio or video capture card on the 
RealProducer computer. 


Files or Live Sources Used as Inputs 


& Input 
———_____» 
File RealProducer 
oo 
oo 
Input og 
— oo 
oo 
a og 
Audio 
Device RealProducer 
oo 
od 
Input oo 
ne og 
og 
e oo 
Video 
Device RealProducer 
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For More Information: For a list of acceptable input formats, 
refer to “Audio and Video Input Formats” on page 25. 


Audio and Video Editing Programs 


Before you encode a clip with RealProducer, you can use the audio or video 
editing program of your choice to edit a digitized input file. Using this 
program, you can set a video’s length, for example, cropping out any 
unnecessary parts. Although RealProducer provides some editing functions 
such as cropping, it does not provide all of the advanced features found in 
audio and video editing programs. 


Tip: The quality of a streaming audio or video clip starts with 
the source file. The more you know about audio and video 
editing, the better you'll be able to produce a great streaming 
clip. For some pointers about preparing files for encoding, see 
Chapter 4 and Chapter S. 


RealProducer Features 
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Once you have your media input ready, you can encode the input as a 
RealVideo or RealAudio clip. Taken together, these clip types are called 
RealMedia. This section explains the aspects of RealProducer you use to encode 
a RealMedia clip or broadcast. 


Encoding Methods 


On Windows, there are two ways to run RealProducer. You can use the 
RealProducer graphical application, or run the RealProducer command-line 
application. On Linux, you can use the command-line application. 


Graphical Application 


The RealProducer graphical application provides an easy-to-use interface for 
encoding RealMedia clips and broadcasts. Using the graphical application, 
you can drag-and-drop input files, select your encoding options, and save the 
encoded output to a clip or send it to a server for broadcast. Chapter 6 
explains the basic procedures for using the graphical application. 
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Command-Line Application 


You can run the command-line application from the command prompt on 
Windows or Linux. It provides all of the features of the graphical application, 
as well as a few advanced features not available through the graphical 
application. See Chapter 14 for information about running the command-line 
application. 


Jobs and Job Files 


A job is a central aspect of encoding RealMedia with RealProducer. The job 
defines how to encode your clip or broadcast. It selects the media inputs, sets 
the encoding properties, and defines the destinations, such as whether to save 
the encoded stream to a clip, forward it to a server for broadcast, or both. 


The Structure of aJob 


Job 


Helix 
Server 


Input Output 


ooooo 
oooo0o0 
A 


Encoding 


Sources Destinations 


Whether you use the graphical application or the command-line application, 
you can save your job settings in a job file for later use. You can also modify a 
job file’s settings, either through RealProducer or by hand, to create a new job 
quickly. The job file uses an XML-based format to define all of the job’s 
encoding settings. 


For More Information: The section “Using Jobs” on page 83 
explains how to define jobs through the graphical application. 
See “Job File Options” on page 249 for information about 
specifying jobs on the command line. Appendix B explains the 
job file syntax. 
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Audiences 


When you set up a job, you choose one or more audiences. An audience defines 
several aspects of the encoding job. Most importantly, it defines the bit rate at 
which a clip or broadcast streams. For a downloadable clip, the audience 
selection affects the clip’s quality and file size. Selecting an audience is 
therefore one of the most important decisions you make when encoding a 
clip. RealProducer predefines a number of audiences designed for low- 
bandwidth streaming to modems and smartphones, high-quality download 
files, and many other uses. 


For More Information: Chapter 7 describes the predefined 
audiences. “Choosing Audiences” on page 98 explains how to 
select audiences through the graphical application. The section 
“Audience Definitions or Audience Files (-ad)” on page 269 
does the same for the command-line application. You can also 
create your own audiences, as explained in “Creating and 
Editing Audiences” on page 153. 


Constant Bit Rate and Variable Bit Rate Audiences 


Each audience is either constant bit rate (CBR) or variable bit rate (VBR). The 
CBR audiences are designed for streaming. When you use them, you can 
encode multiple audiences into a clip or broadcast. For example, a single clip 
can stream to 56 Kbps modems and faster broadband connections when you 
use CBR encoding. 


The VBR audiences are designed for downloadable clips, but can also be used 
for streaming in some instances. When you encode a downloadable clip, you 
select a VBR template according to how highly you want to compress the 
input, or how well you want to preserve the input’s quality. Unlike CBR clips 
that can have multiple audiences, VBR clips can include just one audience. 


For More Information: For background about CBR and VBR, 
refer to “Constant Bit Rate Video” on page 61 and “Variable Bit 
Rate Video” on page 64. 


Audience Files 


RealProducer stores audience information in an XML-formatted audience file 
that you can edit by hand. You can also copy and modify an existing file to 
create your own audience definition. Appendix C explains the audience file 
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syntax. Refer to the section “Audiences Section” on page 329 for information 
about how to copy audience file information into a job file. 


Destinations and Outputs 


Each job defines an output, which is the encoded media data and all of its 
properties. To define where RealProducer sends its output, you specify one or 
more destinations. 


Single and Multiple Destinations 


A destination may be an encoded RealMedia clip, which is a file that uses the 
file extension .rm or .rmvb. Or, server destinations can send the encoded 
output to one or more Helix Servers for broadcast. All destinations receive the 
same output data. If network problems prevent encoded data from reaching a 
server destination, for example, a clip destination still records the data. 


Multiple Destinations for Job Output 


Output 
‘om .rm File 
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Helix Server 1 


For More Information: You can encode multiple destinations for 
a single output through the graphical application as described 
in “Selecting Inputs and Destinations” on page 87. “File and 
Server Outputs” on page 319 explains how to define 
destinations within a job file. 


Multiple Outputs 


RealProducer also lets you define multiple outputs that have different 
properties. From the same video input, for example, you might encode a large 
video clip for fast, broadband connections, and a smaller video clip for slow 
modem connections. Because each video has a different size, it is a separate 
output. Each of these outputs can have one or more destinations, whether 
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saved as a clip or sent to a server. Encoding multiple outputs is possible when 


you define the outputs in a job file and run the job file through the 
command-line application. 


Multiple Outputs with Multiple Destinations 


Outputs Destinations 
ae 
.rm File 
> 
—4— 
a Output 1 
~~ 320 x 240 te Helix Server 
ogo 
RealProducer i 
.tm File 
> 
Output 2 
176 x 132 


Helix Server 


For More Information: For information about defining multiple 
outputs in a job file, see “File and Server Outputs” on page 319. 


Additional Encoding Settings 


In addition to the audience selection, your job can define many additional 
encoding parameters. 


Clip Information 


Clips or broadcasts standardly encode information such as the presentation’s 
title, author, and copyright. The section “Adding Clip Information” on page 
92 explains how to add clip information through the graphical application. 
Refer to the section “Clip Information Options” on page 256 for instructions 
about doing this through the command-line application. You can also add 


clip information directly to a job file, as described in “Clip Information” on 
page 295. 


Video Filters 


Video filters allow you to alter and improve the video input before encoding it. 
You can use these filters to remove artifacts such as video noise, as well as to 
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crop and resize the video. The section “RealVideo Filters” on page 74 explains 
the filters. See the section “Filtering Video Input” on page 93 for information 
about applying filters through the graphical application. “Prefilter Options” 
on page 258 explains how to specify filters on the command line, and 
“Prefilters” on page 307 covers the filter syntax used in the job file. 


Clip Modification 


After you have encoded a RealMedia clip using RealProducer, you can move 
the clip to Helix Server for streaming, or place it on a download server. 
However, you may first want to use another application to edit or modify the 
encoded clip. 


RealMedia Editor 


The RealMedia Editor allows you edit an encoded RealVideo or RealAudio clip. 
For example, you can use this application to change the clip information, 
remove a scene from a video, or combine several clips into a single clip. The 
RealMedia Editor is included with RealProducer Plus. You can run it asa 
graphical application on Windows, or a command-line application on 
Windows or Linux. Chapter 12 explains how to run the RealMedia Editor. 


Events Files 


Using the RealMedia Events utility, you can encode clip information into an 
existing RealAudio or RealVideo clip. You can also add image maps or timed 
URLs to the clip. This allows viewers to click a video clip to open related Web 
pages in their browser. Or, an audio or video clip can open Web pages 
automatically when the clip reaches certain positions in its timeline. See 
Chapter 13 for information about defining clip events. 


Digital Rights Management 


If you need to protect media assets, you can use RealNetworks’ digital rights 
management technology. Using Helix DRM Packager, you can encrypt the 
contents of a RealMedia clip, then assign rights to that clip on an individual 
basis using Helix DRM License Server. Digital rights management is an 
optional and separate part of the media encoding process. 
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Note: For more about RealNetworks’ DRM technology, visit 
http://www.realnetworks.com/products/drm/index.html. 


Presentations 
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Ram File 


Once you encode a clip, it is ready for streaming or downloading. Additionally, 
you can use various scripting or markup languages to combine multiple clips 
and Web pages into a media presentation. Other guides available from 
RealNetworks explain scripting and markup languages you can use with clips 
and broadcasts encoded by RealProducer. 


For More Information: You can download RealNetworks’ 
content creation guides in PDF or HMTL format from 
http://service.real.com/help/library/encoders.html. 


When your presentation is ready to stream, you may want to write a Ram file, 
which is so-named because it uses the file extension .ram, as in movie.ram. Also 
known as a metafile, the Ram file links your Web page to your media. Although 
a Ram file is not necessary when you stream a clip or broadcast using Helix 
Server, it is useful for passing simple parameters to RealPlayer. It might 
instruct RealPlayer to open the clip in full-screen mode, for example, or 
provide the URL to a Web page that displays as the clip plays. 


For More Information: For information about writing a Ram 
file, refer to the Ram file chapter in Introduction to Streaming 
Media. The Ram file is also covered in the presentation delivery 
chapter of RealNetworks Production Guide. 


SMIL Presentations 


You can also create a Synchronized Multimedia Integration Language (SMIL) file to 
integrate several clips into a single presentation. SMIL is the standard markup 
language for timing and controlling streaming media clips. Using a SMIL file, 
you can coordinate the layout and playback of multiple media clips in parallel 
(simultaneously) or in sequence. SMIL can also open HTML pages as a clip 
plays and provide interactive options, such as playing one of three different 
videos depending on which button the viewer clicks. 


CHAPTER 2: Media Basics 


Note: For the basics of SMIL, see Introduction to Streaming Media. 
For a comprehensive look at SMIL, refer to RealNetworks 
Production Guide. 


Javascript Methods 


RealPlayer supports Javascript and VBScript methods that you can use to play 
clips based on viewer interaction with forms or elements displayed in a Web 


page. If you are familiar with Web-based scripting, refer to RealPlayer Scripting 
Guide for more information. 


Media Delivery 


Just as a Web server delivers Web pages to browsers, Helix Server serves 
streaming media to RealPlayer. Using Helix Server, you can stream clips that 
you have encoded using RealProducer. You can also set up live broadcasts in 
which RealProducer encodes live content in real-time, sending it to Helix 
Server for distribution to RealPlayer viewers. 


RealProducer, Helix Server, and RealPlayer 


; RealPlayer 

RealProducer Helix Server y 

For More Information: For information about Helix Server 
features, refer to Helix Server Administration Guide, which you 
can browse or download from 


http://service.real.com/help/library/servers.html. 


On-Demand Clip Streaming 


To deliver a streaming presentation, you need to have access to Helix Server. If 
you are not running Helix Server yourself, the Helix Server administrator can 
set up a method for you to deliver content. To stream a clip on-demand, you 


simply transfer the clip to a Helix Server content directory and add a link to 
the clip in a Web page. 
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Live Broadcasts 


Broadcasting a live event requires a closer coordination between RealProducer 
and Helix Server. The Helix Server administrator must set up certain server 
features to allow the broadcast stream. On RealProducer, you define certain 
server parameters that allow RealProducer to deliver the live stream. Chapter 
10 explains the issues involved with broadcast. Refer to Chapter 11 for 
instructions about delivering a broadcast stream to Helix Server. 


CHAPTER 


3 


INSTALLATION 


This chapter describes the hardware and software requirements for 
RealProducer, and explains how to install the product. Instructions 


are given for Windows and Linux operating systems. 


Audio and Video Input Formats 


You can use the following file formats as input sources on any operating 
system that runs RealProducer. Using these formats does not require 
installing other audio and video software: 


+ Uncompressed AVI 
+ Uncompressed QuickTime 3, 4, and 5 
- WAVE audio files 


Note: It is better to work with uncompressed formats. 
Otherwise, you compress the source once when you digitize it 
and again when you encode it as RealVideo. This double 
compression can decrease the image quality. Use a compressed 
source format only if RealProducer supports the file as input. 
You can use compressed AVI files as long as the RealProducer 
computer has the same Video for Windows driver used to 
compress the AVI file. 


Tip: Always keep copies of the video source files. You cannot 
convert RealVideo clips back to their original source formats 
or any other streaming formats. 


Formats Requiring DirectX 


You can use the following file formats as inputs on Windows if you have 
DirectX 6 or higher installed. Some formats require DirectX 8: 


+ Compressed AVI (.avi) 
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- AIFF (.aif, .aifc, .aiff) 


+ Moving Pictures Experts Group (.mpg, .mpeg, .m1v, .mp2, .mp3, .mpa, 
.mpe, .mpv2, .m3u) 


« Audio for Windows (.wav) 


* QuickTime 2 Content (.mov, .qt) 


For More Information: For the latest version of DirectX, go to 
http://www.microsoft.com. 


Formats Requiring QuickTime 


The following file formats can be used as sources on Windows if the latest 
version of QuickTime is installed: 


+ AU (““ULAW”) (.au, «snd, .ulw) 

+ Sound Designer II (“Sd2f,” “SD2”) (.sd2) 

* DV (“dvc!”) (.dif, .dv) 

* QuickTime Flattened Movie (“MooV”) (.mov, .qt) 
* MPEG-4 


Input Color Formats 
The following color formats are supported for video captures: 


¢ YUV12. This format is also known as 1420. It is the native color format 
used by RealVideo codecs. Using 1420 as input improves performance by 
removing the need to convert the color format before encoding. 


+ RGB 15, 16, 24, 322. 
* BGR 15, 16, 24, 32. This is the Macintosh version of RGB.) 


- The following Windows YUV Formats: YUY2, YV12, YVU9, YVYU, CYUV, 
IYUV, UYNV, UYVY, V422, YUNV. 


- The following Macintosh YUV Formats: 2VUY, YUVS, YVYU, YUVU, 
YVU9, YUV2, V210. 
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Windows Requirements and Installation 


This section outlines the basic hardware and software requirements needed to 
run RealProducer in a Windows environment. This section also gives you step- 
by-step instructions for installing the product onto a Windows machine. 


Windows System Requirements 


The following table lists the minimum and the recommended requirements 
for using RealProducer 10 on Windows. 


Windows Requirements 


Requirement Minimum Recommended 
CPU 400 MHz 2.4 GHz or faster Pentium IV 
RAM 128 MB 512+ MB 
Operating System Windows XP Windows XP 
Windows 2000 Windows 2000 
Windows NT 4, SP 6 
Windows ME 
Windows 98 SE 
Hard Disk space 30 MB 
(software) 
Hard Disk space (data) | 500 MB 1 GB 
Color Display 16-bit 24-bit (TrueColor) 
Sound Card 16-bit sound card or better 


Installing RealProducer on Windows 


Follow this procedure to install the product onto a computer running 
Windows. 


> To install RealProducer onto Windows: 


1. Download the installation program or insert the CD-ROM into your 
drive. 


2. Close any other applications that may be open and double-click on the 
installation program icon. The installer unpacks the required files and 
opens the License Agreement. 


27 


RealProducer 10 User’s Guide 


10. 


11. 


. Read the terms and conditions carefully, and select l accept the terms in the 


licence agreement if you agree. You can click Cancel at any time to abort the 
installation. 


. Click Next to continue. The Serialization page opens. 


. Enter your name, company name, and serial number you received when 


you purchased RealProducer. 


. Click Next to continue. The Install Options page opens. 


. The default install directory that RealProducer will install to your 


computer is listed. You can change this default install directory by clicking 
the Browse button and selecting the new path. 


. You also have the options to select whether a shortcut to RealProducer 


will be created on the desktop and/or on the Quick Launch toolbar, and 
whether command line tools will be added to your PATH. 


Warning! You must have enough disk space and write access to 
the location where you intend to install RealProducer. If not, 
you will not be able to continue the installation. 


. Click Next to continue. The install program installs all necessary files and 


opens the Finishing Up page. 


Choose whether you want to launch RealProducer and/or the Readme file 
when you exit the install program. 


Click Finish to exit. 


Linux Requirements and Installation 
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This section outlines the basic hardware and software requirements needed to 
run RealProducer in a Linux environment. This section also gives you step-by- 
step instructions for installing the product onto a Linux machine. 


Linux System Requirements 


CHAPTER 3: Installation 


The following table lists the minimum and the recommended requirements 


for using RealProducer on Linux. 


Requirement 


Linux Requirements 


Minimum 


Recommended 


Version Linux 2.2 and 2.4 with glibc 2.1 or greater 

CPU 400 MHz 2.4 GHz or faster 
Pentium IV 

RAM 128 MB 512+ MB 

Hard Disk space 30 MB 

(software) 

Hard Disk space (data) | 500 MB 1 GB 


RealProducer should install and run properly ony any Linux distribution that 
meets the requirements in the preceding table. The following distributions are 


tested and supported: 


+ Mandrake 7.2 and higher 
+ Redhat 6.0 and higher 


+ Slackware 7.0 and higher 


- SUSE 6.2 and higher 
+ Debian 2.2r3 and higher 


Installing RealProducer on Linux 


Follow this procedure to install the product onto a computer running Linux. 


> To install RealProducer onto Linux: 


1. Download the installation program, or insert the CD-ROM into your 


drive. 


2. Make sure your CD drive is mounted properly, if installing from a CD. 


3. Copy the installer to your hard drive if you are getting it from a CD. 


4. Start RealProducer installer by entering one of the following, depending 
on whether you have RealProducer Plus or RealProducer Basic: 


sh realproducer_plus_10_linux_setup.bin 


sh realproducer_basic_10_linux_setup.bin 
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The installer extracts the necessary files to the directory where the 
installer is located. It then installs all necessary programs and files. When 
complete, the installer shows the Software License agreement. 


5. With RealProducer Plus, enter the serial number when prompted. 


Other Basic Requirements 


In addition to normal hardware and software requirements, RealNetworks 
recommends that you have the following products: 


- RealPlayer 10 
+ speakers or headphones connected to your sound card 


For recording from a media device, you should have any of the following 
connected to your computer: 


+ video capture card, if encoding live video 
- S-VHS, Digi-Beta, or Beta-SP video player 
+ video camera 

+ microphone 


To send audio and video directly to your computer, you will need the 
following: 


- A media device such as a VCR, video camera, or microphone. 
+ For capturing live audio, a sound card. 


- For capturing live video, a video capture card, unless you can connect a 
video device directly to your computer by IEEE -1394 (Firewire, iLink), or a 
USB port. 
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ENCODING BASICS 


The following chapters explain how to set up, start, and 
monitor an encoding job using the RealProducer graphical 
application. Chapter 7 describes the default audiences, which 


you can use with the graphical or command-line application. 


PART 


CHAPTER 


4 


PRODUCING AUDIO 


RealNetworks pioneered streaming audio with RealAudio, the first 
streaming media product for the Internet. Since its debut in 1995, 
RealAudio has become the standard for network audio, delivering 
stereo sound over 28.8 Kbps modems and CD-quality sound at high 
connection speeds. This chapter provides a reference for the 
RealAudio codecs, and gives pointers on how to prepare and encode 


your sound files for streaming or downloading. 


For More Information: See also “Adjusting Audio Gain” on page 
143 and “Audio Delay Compensation Prefilter” on page 317 for 
information about audio filters that you can use with 
RealProducer. 


Understanding RealAudio 


Because RealAudio clips are compressed, you typically start with a sound file 
in a digitized, uncompressed format such as WAV or AIFF. Using 
RealProducer, you create a RealAudio clip from the source file. RealAudio 
clips typically use the file extension .rm, although clips may also end with 
.tmvb (variable bit-rate clip) or .ra (audio file created by RealPlayer). The 
following sections explain how RealAudio encodes an audio file for streaming. 
This information will help you to produce high-quality streaming clips. 


Bandwidth and Audio Quality 


One way that RealAudio codecs squeeze an audio file’s size down is by 
throwing out nonessential data. This makes it a lossy compression format. 
RealAudio doesn’t delete data indiscriminately, though. It first jettisons 
portions you cannot hear, such as very high and very low frequencies. Next, it 
removes as much data as needed while keeping certain frequencies intact. 
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Voice encoding favors frequencies in the normal human speaking range. 
Music encoding retains a broader frequency range. 


Although RealAudio is savvy about what audio data it throws out, be aware 
that the lower the target streaming speed, the more data gets ejected, and the 
cruder the sound quality becomes. At low bandwidths, you get roughly the 
quality of an AM radio broadcast. With faster connections, you can encode 
music with FM-quality sound. And at the high speeds of DSL, cable modems, 
and LANs, RealAudio sound quality rivals that of CD or multichannel DVD 
playback. When creating RealAudio clips for any bandwidth, it’s important to 
start with high-quality input, as described in “Audio Capture” on page 48, to 
attain good sound quality. 


RealAudio Bandwidth Characteristics 


You create a RealAudio clip by using one or more RealAudio codecs. A codec is a 
coder/decoder. It tells RealProducer how to turn audio source files into 
RealAudio clips. On the receiving end, RealPlayer uses codecs to expand clips 
into audio data the computer can play. RealAudio employs a series of codecs, 
each of which creates an audio stream for a precise bandwidth. One codec 
compresses mono music for a 28.8 Kbps modem. Another one compresses 
stereo music for that same modem speed. This set of codecs is different from 
the set used to compress music for, say, DSL and cable modem connections. 


A RealAudio clip consumes bandwidth at a flat rate determined by the codec 
used to encode the clip. A RealAudio clip encoded with a 20 Kbps codec, for 
example, steadily consumes 20 Kbps of bandwidth as it plays. The following 
table lists the standard bit rates for RealAudio clips encoded for specific target 
audiences by RealProducer. Encoding a voice-only audio file for a 28.8 Kbps 
modem, for example, creates a 16 Kbps streaming clip. With mono music 
input, though, you get a 20 Kbps clip. 


RealAudio Standard Bit Rates 


Voiceand Mono Stereo 
Target Audience Voice Only Music Music Music 
28.8 Kbps modem 20 Kbps |20 Kbps _ | 20 Kbps 
16 Kbps 
56 Kbps modem 32 Kbps |32 Kbps | 32 Kbps 
64 Kbps single ISDN 32 Kbps 44 Kbps |44Kbps_ | 44 Kbps 


(Table Page 1 of 2) 
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RealAudio Standard Bit Rates (continued) 


Voiceand Mono Stereo 
Target Audience Voice Only Music Music Music 
112 Kbps dual ISDN 64 Kbps 64 Kbps 
Corporate LAN 64 Kbps 132 Kbps 
256 Kbps DSL/cable modem 64Kbps_ | 176 Kbps 

96 Kbps t——————— 
384 Kbps DSL/cable modem send 264 Kbps 

& [ise ae 

512 Kbps DSL/cable modem . 352 Kbps 


(Table Page 2 of 2) 


Tip: In terms of bandwidth use, RealAudio is inflexible. The 
RealAudio codecs set streaming bit rates in a stairstep model: 
20 Kbps, 36 Kbps, 44 Kbps, and so on, with no inbetween 
choices. Because RealAudio clips always stream at specific bit 


rates, consider their bandwidth needs first when you use them 


in multiclip presentations. Then create your other clips to 


stream within the remaining bandwidth. 


For More Information: With SureStream technology, a single 


RealAudio clip can stream at many different speed. For the 


basics of SureStream, see “SureStream CBR Clips” on page 61. 


RealAudio Codecs 


When you encode a RealAudio or RealVideo clip using RealProducer, you do 


not select the RealAudio codec directly. Instead, you choose your audience 


settings, as described in the section “Choosing Audiences” on page 98. You 


might select one audience, such as 256 Kbps DSL users, or encode multiple 


audiences into a single SureStream clip that can stream at different bit rates. 


Unless you wish to change the audience defaults, you just need to select the 


right audience settings when you encode a clip to have RealProducer use the 


appropriate RealAudio codec. The audience templates presented in the 


RealProducer graphical user interface always indicate the target streaming 
speed, such as with the “384k DSL or Cable Modem” audience. 


Note, though, that the type of audio input you use can affect your choice of 


audience. If your are using stereo surround audio as your source, you may 


want to encode using the “350k Surround Stereo” audience template instead 


of a template that encodes just standard, two-channel stereo audio. Or, i e 
fa template that des just standard, two-ch Ist dio. Or, if th 
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input is multichannel, you may want to choose the “350k Multichannel” 
audience setting. The following sections explain more about these audio types. 


Additionally, you should note RealPlayer compatibility with the RealAudio 
codecs you use. Old versions of RealPlayer can play audio encoded with voice 
codecs, for example, but only RealOne Player and later can play audio encoded 
with certain stereo, stereo surround, and multichannel codecs. The sections 
that list the available codecs explain compatibility issues. Note, too, that all 
RealPlayers since 1998 have the ability to upgrade automatically to new audio 
codecs or a new player version if the user attempts to play an unsupported 
RealAudio format. 


Tip: Chapter 9 explains how to determine, and change if 
necessary, the codec settings used with each audience setting. If 
you wish to change a default setting, be sure that you 
understand the codec properties described in the following 
sections. 


Understanding the RealAudio Codec Tables 


The following sections describe the RealAudio codecs available through 
RealProducer. The codecs are listed in separate tables for voice, mono music, 
stereo music, stereo surround, multichannel, and lossless audio. Each table 
provides the following information. 


Codec 


The Codec column describes the codec as it appears in the RealProducer 
interface. The name lists the streaming bit rate for the encoded audio, and 
indicates the type of audio input the codec is suited for. 


Type and Flavor 


The Type and Flavor columns identify the codec for use with the command-line 
application. This information is not shown in the RealProducer graphical user 
interface. 


Sampling Rate 


The sampling rate column lists the codec’s optimum sample rate. If the input 
does not have the expected rate, RealProducer resamples the input without 

causing pitch shifting. For best results, the audio input should have the same 
or a higher sampling rate than the codec’s expected rate. For SureStream clips, 
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the input sampling rate should be equal to or greater than the largest sample 


rate of all codecs used. Although RealProducer accepts audio input at any 


sampling rate, it is optimized for the following rates: 


-4kHz 
-8kHz 


¢ 11.025 kHz 
- 16 kHz 


+ 22.05 kHz 
+ 24 kHz 

+ 32 kHz 

* 44.1 kHz 
- 48 kHz 

- 96 kHz 


Voice Codecs 


Tip: After you load a digitized clip as input, a process described 
in “Using a File as the Input” on page 87, you can click the 
Source Properties button to display the audio properties, 
including the sampling rate. 


For More Information: RealProducer allows you to choose high- 
quality resampling (recommended) or fast resampling. The 
section “Setting Audio Parameters” on page 96 explains how to 
set this option in the graphical application. See “Audio 
Resampling Quality (-arq)” on page 272 and “Media Profile 
Properties” on page 325 for information about setting this 
option through the command-line application or job file, 
respectively. 


Voice codecs produce the best results for voice-only audio input. The lowest- 


speed voice codec normally used to encode a RealAudio clip streams data at 16 
Kbps. The lower-speed codecs (5, 6.5, and 8.5 Kbps) are used as SureStream 
duress streams when the connection bandwidth drops. They’re also used to 


encode soundtracks for low-bandwidth RealVideo clips. The following table 
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lists the available voice codecs, which are compatible with RealPlayer G2 and 


later. 
RealAudio Voice Codecs 

Codec Type Flavor Sampling Rate 
5 Kbps voice sipr 2 8 kHz 
6.5 Kbps voice sipr 0 8 kHz 
8.5 Kbps voice sipr 1 8 kHz 
16 Kbps voice sipr 3 16 kHz 
32 Kbps voice cook 7 22.05 kHz 
64 Kbps voice cook 14 44.1 kHz 


Mono Music Codecs 


Music codecs are designed to encode audio with a larger pitch variance than 
voice. You will capture a broader, fuller sound with codecs designed for higher 
bit rates. As with the voice codecs, the lowest-speed mono music codec 
normally used with RealAudio streams data at 16 Kbps. The lower-speed 
codecs (6, 8, and 11 Kbps) are used as duress streams in SureStream clips, and 
to encode soundtracks for low-bandwidth RealVideo clips. When there are two 
versions of a codec, RealProducer uses the higher-response version by default. 


About High-Response Codecs 


The 20 kbps, 32 kbps, and 44 kbps music codecs come in two varieties. By 
default, RealProducer uses the “high response” versions, which are the better 
codecs for most situations. But you can also use the “normal response” 
versions by changing your audience templates, as described in Chapter 9. 


The high response codecs cover a larger frequency spectrum than the normal 
response versions. Sometimes, the high response version has twice the range as 
the normal codec. This means it provides crisper sound and is better at 
capturing high frequencies. With symphonic music, for example, the high 
response codec gets more of the flute and piccolo. It can produce more 
distortion than the normal response codec with voices and loud sounds such 
as drums, though. 


If you are encoding music with a diverse range of frequencies, stick with the 
high response codecs. If you notice distortion, compare your results with a clip 
that uses the normal response codecs. The best tool for determining which 
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codec to use is your ear. Listen carefully for minute differences in how the clip 
sounds. It also helps to have other people listen. Our own ears have different 
frequency responses, too. 


Available Mono Music Codecs 


You can use the following codecs to encode audio files as mono music. All 
mono music codecs are compatible with RealPlayer G2 and later. 


Mono Music Codecs 


Codec Type Flavor Sampling Rate 
6 Kbps Music - RealAudio cook 8 8 kHz 

8 Kbps Music - RealAudio cook 0 8 kHz 

11 Kbps Music - RealAudio cook 1 8 kHz 

16 Kbps Music - RealAudio cook 2 8 kHz 

20 Kbps Music - RealAudio cook 3 11.025 kHz 
20 Kbps Music High Response - RealAudio | cook 15 22.05 kHz 
32 Kbps Music - RealAudio cook 4 22.05 kHz 
32 Kbps Music High Response - RealAudio | cook 16 44.1 kHz 
44 Kbps Music - RealAudio cook 5 44.1 kHz 
64 Kbps Music - RealAudio cook 6 44.1 kHz 


Stereo Music Codecs 


Use stereo music codecs for encoding traditional, two-channel stereo music. 
RealProducer also uses these codecs when you encode voice-with-music clips. 


Types of Stereo Music Codecs 


You can encode many different bandwidths of stereo music, using three 
different stereo codecs: 


+ The oldest stereo music codecs produce lower quality sound than newer 
codecs, but are compatible with RealPlayer G2 and later. 


+ Stereo music codecs listed as “RealAudio” in the following table provide 
high quality stereo sound compatible with RealPlayer 8 and later. 


Note: At several bandwidths, you can choose between normal 
and high response versions of the stereo codecs. RealProducer 
uses the higher-response version by default. But you can 
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change to a normal response version as described in “Creating 


and Editing Audiences” on page 153. 


For More Information: The section “About High-Response 


Codecs” on page 38 explains the difference between normal 


and high-response audio encoding. 


+ The codecs listed as “RealAudio 10” in the following table and the 
RealProducer interface are based on Cook and AAC technology. They are 


compatible with RealOne Player (a codec autoupdate is required) and 


later, including RealPlayer 10. 


Available Stereo Music Codecs 


The following stereo music codecs are available in RealProducer 10. 


Stereo Music Codecs 


Codec Type Flavor Sampling Rate 
12 Kbps Stereo Music - RealAudio cook | 26 11.025 kHz 
16 Kbps Stereo Music - RealAudio cook /|17 22.05 kHz 
20 Kbps Stereo Music cook |9 11.025 kHz 
20 Kbps Stereo Music - RealAudio cook /|18 22.05 kHz 
20 Kbps Stereo Music High Response - RealAudio |cook | 19 22.05 kHz 
32 Kbps Stereo Music cook /|10 22.05 kHz 
32 Kbps Stereo Music - RealAudio cook | 20 22.05 kHz 
32 Kbps Stereo Music High Response - RealAudio [cook | 21 44.1 kHz 
44 Kbps Stereo Music cook /|11 22.05 kHz 
44 Kbps Stereo Music - RealAudio cook | 22 44.1 kHz 
44 Kbps Stereo Music High Response - RealAudio |cook | 23 44.1 kHz 
64 Kbps Stereo Music cook | 12 44.1 kHz 
64 Kbps Stereo Music - RealAudio cook | 24 44.1 kHz 
64 Kbps Stereo Music - RealAudio 10 raac 0 44.1 kHz 
96 Kbps Stereo Music cook | 13 44.1 kHz 
96 Kbps Stereo Music - RealAudio cook | 25 44.1 kHz 
96 Kbps Stereo Music - RealAudio 10 raac 1 44.1 kHz 
128 Kbps Stereo Music - RealAudio 10 raac 2 44.1 kHz 
160 Kbps Stereo Music - RealAudio 10 raac 3 44.1 kHz 


(Table Page 1 of 2) 
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Stereo Music Codecs (continued) 


Codec Type Flavor Sampling Rate 
192 Kbps Stereo Music - RealAudio 10 raac 4 44.1 kHz 
256 Kbps Stereo Music - RealAudio 10 raac 5 44.1 kHz 
320 Kbps Stereo Music - RealAudio 10 raac 6 44.1 kHz 


(Table Page 2 of 2) 


Stereo Surround Codecs 


Encode your audio using a stereo surround codec if you know that the source 
audio is matrixed, multiple-channel sound, and you wish to preserve the 
multiple channels for your listeners. Because stereo surround is compatible 
with conventional stereo systems, listeners who do not have stereo surround- 
enabled equipment will still be able to hear the two main channels. Stereo 
surround audio and video clips are suitable for streaming or download. 


What is Stereo Surround? 


Stereo surround audio includes more channels than traditional stereo, which 
uses just the left and right channels. These additional channels are mixed (or 
matrixed) into the conventional left and right stereo channels. This allows 
older receivers to play just the left and right channels, while newer receivers 
enabled for stereo surround can extract from the left and right channels the 
audio data for the additional speakers. 


For More Information: You can find background about 
producing stereo surround input at the Dolby Laboratories 
Web site at http://www.dolby.com/tech/. See also 
http://www.realnetworks.com/resources/index.html for 
additional information. 


Channel Support for Stereo Surround Audio 


The RealAudio stereo surround codecs preserve the matrixed, multichannel 
surround audio in the audio input. RealProducer supports any number of 
matrixed channels. Because the audio input is standard stereo input, the 
computer running RealProducer does not require a special sound card or 
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cabling. The following table explains the common channel arrangements 
found in matrixed, stereo surround audio. 


Common Channel Arrangements in Matrixed, Stereo Surround Audio 


Channels Description 


4 To the standard left and right channels, this arrangment adds a front 
center and a rear center channel. 


5.1 This type of matrixing uses five main channels: left, center, right, left 
surround, and right surround. The “.1” refers to a sixth, low-frequency 
effects (LFE) bass channel that covers a fraction of the frequency range of 
the main channels. 


6.1 Building on the 5.1 arrangement, this type of matrixing adds two 
additional channels for playback on two additional speakers. 


7.1 Also building on the 5.1 arrangement, this type of matrixing adds four 
additional channels for playback on two additional speakers. 


Sources of Stereo Surround Audio 


It is important to note that RealProducer does not mix the multichannel 
stereo surround into the left and right stereo channels itself. The source you 
are encoding, whether a static clip or live input, must be matrixed already. This 
type of audio content is typically created using encoders by Dolby 
(http://www.dolby.com), CRS Labs, or Digital Theater Systems 
(http://www.dtsonline.com/). These sources are prevalent on DVDs and 
television broadcasts. Although you can use non-digital multichannel sources, 
digital sources provide the best results. 


Playback of Stereo Surround Audio 


To hear the matrixed, multichannel sound, RealPlayer users can play the audio 
on an A/V receiver, such as a home theater system, that is equipped with stereo 
surround decoding, and that is connected to the surround channels and 
optional subwoofer. As well, some computer speakers will play stereo 
surround audio directly. Audio systems not enabled for stereo surround play 
just the standard left and right stereo channels. 


Standard Stereo Codecs for Stereo Surround Audio 


If you do not want to preserve the stereo surround information, you can 
encode your audio with an audience template that uses the conventional 
stereo codecs described in “Stereo Music Codecs” on page 39. The primary 
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reason to do this is to stream at bandwidths lower than those available for 
stereo surround. By using a SureStream clip, you can encode low-bandwidth 
streams in conventional stereo, and high-bandwidth streams that use stereo 
surround audio. 


Standard Stereo Input for Stereo Surround 


If your audio source is traditional, two-channel stereo, do not encode the 
input using stereo surround audio codecs. Although traditional stereo 
encodes OK as stereo surround audio, RealProducer does not create the extra 
channels (it only preserves existing channels), so using stereo surround audio 
codecs does not enhance the listening experience. Additionally, the standard 
stereo codecs are more efficient at encoding two-channel stereo than the 
stereo surround audio codecs. 


Available Stereo Surround Codecs 


RealProducer can encode stereo surround audio with any of the following 
codecs. The three “RealAudio” codecs are compatible with RealPlayer 8 and 
later. The “RealAudio 10” codecs, which are based on AAC technology, are 
compatible with RealOne Player (a codec autoupdate is required) and later, 
including RealPlayer 10. 


Stereo Surround Audio Codecs 


Codec Type Flavor Sampling Rate 
44 Kbps Stereo Surround Audio - RealAudio cook | 29 22.05 kHz 

64 Kbps Stereo Surround Audio - RealAudio cook | 27 44.1 kHz 

96 Kbps Stereo Surround Audio - RealAudio cook | 28 44.1 kHz 

128 Kbps Stereo Surround - RealAudio 10 raac 7 44.1 kHz 

160 Kbps Stereo Surround - RealAudio 10 raac 8 44.1 kHz 

192 Kbps Stereo Surround - RealAudio 10 raac 9 44.1 kHz 

256 Kbps Stereo Surround - RealAudio 10 raac 10 44.1 kHz 

320 Kbps Stereo Surround - RealAudio 10 raac 11 44.1 kHz 


5.1 Multichannel Audio Codecs 


The multichannel RealAudio codecs preserve the discrete, multiple channels 
in the audio source. Use them if you know that the source audio includes 
multichannel sound, and your intended listeners have home theater systems 
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or other equipment able play all of the channels. Multichannel audio and 
video clips are suitable for streaming or download. 


What is Multichannel Audio? 


Like stereo surround audio, multichannel audio includes channels in addition 
to the left and right stereo channels. Unlike stereo surround, however, 
multichannel audio encodes the additional channels separately, rather than 
mixing all channels into the signals for the left and right speakers. For this 
reason, multichannel audio is often called discrete multichannel, rather than 
the matrixed multichannel of stereo surround audio. 


Using multichannel audio preserves the optimum sound quality of 
multichannel audio. With stereo surround, the matrixing process may 
replicate some audio data meant for one channel on another channel. (This is 
an artifact of the stereo surround mixing in the audio source, rather than the 
RealAudio encoding.) 


Sound System Requirements for Multichannel Audio Encoding 


To use discrete, multichannel audio, your sound system must capture and 
preserve each channel. If you start with an uncompressed, prerecorded file, for 
example, that digitized file format must preserve the additional channels. A 
common audio format to use with multichannel audio is AC3, which can be 
digitized as an MPEG, QuickTime, AVI, or Wave file. The sound card used 
with the RealProducer computer must also support the additional input 
channels. A standard sound card supporting only two-channel stereo input 
will therefore not work for discrete, multichannel audio. 


Channel Support for Multichannel Encoding 


RealProducer encodes all multichannel output as 5.1 channels (left, center, 
right, left surround, right surround, LFE bass). It can accept fewer than six 
channels as input, upsampling as necessary to create the 5.1 channels. The 

obsolete quadraphonic multichannel format, which uses two front and two 
back channels, is not supported. 


Multichannel Input Formats 


RealProducer can encode multichannel input from a file but not from a live 
capture. You can use the following audio source formats as input for the 
RealAudio multichannel codecs: 


- DirectShow (Windows Only) 
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- Uncompressed Wave (.wav) 
+ Uncompressed AVI (.avi) 
+ Uncompressed QuickTime (.mov) 


+ Compressed QuickTime (Windows Only) 


Playback of Multichannel Audio 


To hear the different channels in discrete, multichannel audio, RealPlayer 
users on Windows can direct the audio to a multichannel-enabled sound card 
or home theater system. With traditional speaker systems, and on operating 
systems other than Windows, RealPlayer converts the audio signal to the 
standard stereo channels. 


Standard Stereo Codecs for Multichannel Audio 


As with stereo surround audio, you can encode multichannel audio with 
standard stereo codecs. This does not preserve the multiple channels, however. 
For example, you might create a SureStream RealAudio clip that streams 
multichannel audio at high bandwidths and standard stereo at low bit rates. 
You should not encode standard stereo input with the multichannel codecs, 
however, as the quality will not be as high as when you use standard stereo 
codecs. 


Available Multichannel Codecs 


The following codecs are available for high-bandwidth, multichannel 
recordings. All multichannel codecs are compatible with RealOne Player (a 
codec autoupdate is required) and later, including RealPlayer 10. 


Multichannel Audio Codecs 


Codec Type Flavor Sampling Rate 
96 Kbps 5.1 Multichannel - RealAudio 10 cook | 30 22.05 kHz 
132 Kbps 5.1 Multichannel - RealAudio 10 | cook | 31 44.1 kHz 

184 Kbps 5.1 Multichannel - RealAudio 10 | cook | 32 44.1 kHz 

268 Kbps 5.1 Multichannel - RealAudio 10 | cook | 33 44.1 kHz 


Lossless Audio Codec 


RealProducer 10 includes a lossless RealAudio codec that faithfully 
reproduces the full dynamic frequency of the input audio file while 
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compressing the output. The encoded clip, which is saved in the RealMedia 
variable bit rate format (.rmvb), is typically around half the size of the input 
file, though the compression rate varies with different types of input. 


What is Lossless Encoding? 


The RealAudio lossless codec is designed primarily for high-quality music 
downloads in mono or two-channel stereo format (multichannel output is not 


supported). It replicates CD-quality sound in a format that takes less time for 
the user to download. 


The RealAudio lossless codec preserves the exact sound of the input audio 
while compressing the file size to about half the original size. Although the 
lossless audio codec is designed for high-fidelity music downloads, you can 
also use it with with streaming clips and broadcasts in high-bandwidth 
environments. 


Note: The lossless codec is not accessible through the graphical 
user interface. Use the command-line application as described 
in Chapter 14 to encode your files as lossless streams. 


Input Formats for Lossless Encoding 


You can encode any audio or video format acceptable to RealProducer 10 with 
the RealAudio Lossless codec. The codec is optimized for the 16-bit, 44.1 KHz 
audio used in audio CDs, but other sampling rates and bit depths are accepted 
as well. During encoding, you can apply the audio delay, audio gain, or audio 
meter prefilter. 


Output Formats for Lossless Encoding 


The primary, intended output for lossless encoding is a single audio stream 
saved as a downloadable clip. However, you can also use lossless audio when 
encoding constant bit rate or variable bit rate video clips. You can also use 
lossless audio encoding for streaming clips or broadcasts, combining the 
lossless audio track with other audio tracks in a single SureStream clip or live 
stream. 


Player and Server Compatibility for Lossless Audio 


Lossless audio clips can be streamed and downloaded for playback by RealOne 
Player (an automatic codec update is required) and RealPlayer 10. You can 
stream or broadcast using lossless audio with Helix Server version 9 and later 
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servers. The legacy push broadcast mode is not available for broadcasts using 
lossless encoding. 


Streaming Rates for Lossless Audio Clips 


Although a lossless audio stream is intended for downloading, it is also 
designed for streaming. However, unlike audio streams encoded with other 
codecs, a lossless stream does not have a single target stream rate. Instead, the 
streaming rate is approximately the size of the audio data in Kilobits divided 
by the audio duration in seconds. For example, a lossless audio clip that is 6 
Megabytes (49,152 Kilobits) and plays for 2 minutes (120 seconds) streams at a 
rate of 410 Kilobits per second. Use of lossless audio for streaming media is 
therefore recommended only for high-bandwidth situations. 


Tip: If you use lossless audio in a streaming video clip, keep in 
mind that the visual track is compressed to fit within the 
remaining bandwidth of the overall target rate. If the audio 
uses up most of the streaming bandwidth, the video’s visual 
quality will suffer. 


Lossless Audio Encoding Modes 


RealProducer 10 provides three encoding modes—low, medium, and high—that 
affect video and lossless audio. Both modes faithfully reproduce the full audio 
range of the input file. The higher compression modes perform more complex 
analysis on the input, however, resulting in longer encoding times but smaller 
file sizes. Because of the reduced file sizes, the higher compression modes 
create lossless audio clips that stream at lower bit rates. 


Limitations on Editing Lossless Clips 


With one exception, a lossless audio clip cannot be modified: 


- Using RealPlayer 10, users can convert a lossless audio clip to a .wav file, or 
to a lower-fidelity format (such as MP3) for transfer to portable devices. 


+ RealProducer cannot convert a lossless audio clip back to its original 
source format. 


+ RealProducer cannot re-encode a lossless clip using another audio codec. 
You should therefore always maintain your source file if you plan to 
encode additional clips. 


- You cannot edit a lossless audio clip using the RealMedia editor. 
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Available Lossless Codec 


Use the following lossless codec to encode perfect quality sound. The 
RealAudio lossless codec is compatible with RealOne Player (a codec 
autoupdate is required) and RealPlayer 10. 


RealAudio Lossless Codec 


Codec Type Flavor Sampling Rate 


RealAudio Lossless Audio far fo | 44.1 kHz 


Audio Capture 
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A streaming clip reflects the quality of its audio source. Any quality problems 
within the source will affect the streaming clip as well. Because you cannot 
edit a broadcast, live Webcasting introduces several issues beyond those 
involved with delivering on-demand clips. This section will help you capture 
high-quality audio source files, or set up your sound equipment to deliver 
good broadcasts. 


For More Information: For information about broadcasting live 
content, refer to Chapter 10. 


Source Media 


If you plan to stream existing material, start with the best source possible. Use 
the cleanest recording with the least amount of unwanted noise. Compact 
discs (CDs) and digital audio tapes (DATs) are good source media, although 
well-recorded analog sources such as records, reel-to-reel tapes, and chrome 
(type II) cassettes can sound just as good. Try to avoid consumer-grade 
recording media such as Type I cassettes and VHS tapes. 


Recording Equipment 


Every piece of equipment in the audio chain—microphone, mixer, sound card, 
and so on—affects sound quality. If you intend to provide professional-quality 
audio content, invest in professional-quality audio equipment and software. 
Lesser equipment can add hiss and distortion, degrading sound clarity. 
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Shielded Cables 


It is important to use high-quality, shielded cables. Using unshielded cables 
increases the likelihood of introducing line noise and radio frequency 
interference into recordings. Keep audio cables physically separated from 
power cords to minimize the introduction of noise. Also be sure to ground all 
equipment properly. 


Input Levels 


Setting correct input levels is crucial. All audio equipment has a signal-to- 
noise ratio, the ratio between the loudest possible sound the equipment can 
reproduce without distortion and its inherent “noise floor.” Also called 
“clipping,” distortion of this type is audible as a high-frequency crackling 
noise. 


To get the best signal-to-noise ratio, set the input level on each audio device in 
the signal chain so that it uses its full range of available amplitude without 
distortion during the program’s loudest sections. The signal chain typically 
includes a microphone, a mixing desk, a compressor, and a sound card. For 
each piece of equipment, set levels as close as possible to 0 decibels without 
going over that level. 


Check for signal distortion at each point in the signal chain. Perform several 
test runs, and make sure that there are no peaks above maximum amplitude. 
Adjust the levels on your sound card mixer so that the input approaches but 
does not exceed the maximum. Be conservative, though. Levels might 
suddenly increase if, for instance, an interviewee suddenly speaks loudly or a 
crowd at a sports event roars. 


Volume Levels for Live Broadcasts 


When broadcasting live audio streams, it is useful to have a dynamics 
compressor for gain compression (not data compression). This piece of audio 
equipment automatically adjusts the volume level. By providing a consistent 
volume level, it allows you to “set and forget” the input levels to RealProducer. 


Sampling Rates 


Try to capture sound with a sampling width of 16 bits. RealAudio codecs have 
different sampling rates that produce the best sound, however. If your sound 
card allows it, capture audio content at the optimum sampling rate for the 
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codec you intend to use. The RealAudio encoder will convert the file to the 
optimum rate if necessary, but this is recommended only for static files. For 
live broadcasts, use a sound card that supports the optimum rate. This avoids 
the overhead entailed in converting the rate while encoding sound in real 
time. 


For More Information: “RealAudio Codecs” on page 35 lists the 
optimum sampling rates for each codec. 


Tip: You do not need to capture stereo sound if you plan to use 
a mono codec. However, many sound cards simply discard the 
right input channel in mono mode. If you have a mixing desk, 
pan all inputs to the center so that nothing is lost during the 
conversion to mono. 


Audio Optimization 
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If you are not broadcasting audio live, you work with digitized audio source 
files in supported formats such as WAV or AIFF. You then edit the audio files 
to optimize them. To do this, you need to be familiar with the features your 
editing program offers. This section gives you some optimization tips you can 
try with your editing software before encoding your clips with RealProducer. 


Tip: Always keep copies of your audio source files. You cannot 
convert RealAudio clips back to their original source formats. 


DC Offset 


DC offset is low-frequency, inaudible noise that results from equipment 
grounding problems. If you don’t remove it, it can skew the results of 
subsequent sound editing. Use your sound editor’s DC Offset function 
immediately after recording a digital audio file. 


Tip: If your editing program has this option, remove DC offset 
during recording. This eliminates an editing step. 


Normalization 


Set sensible input levels when recording, and then use normalization to 
maximize the levels after recording. Your streaming files sound best when 
your digitized source has the highest possible gain without clipping. Digital 
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audio files that do not use their full amplitude range produce low-quality 
streaming clips. If the amplitude range is too low, use your sound editor to 
adjust the range and increase the amplitude. 


Tip: Most sound editors have a Normalize function that 
maximizes levels automatically. Because some systems have 
trouble with files normalized to 100 percent, normalize to 95 
percent of maximum, or to -0.5dB. 


Dynamics Compression 


Normalization maximizes the volume level of the audio file’s loudest sections. 
Consequently, quiet sections may not encode as well. Dynamics compression 
evens out input levels by attenuating (turning down) the input when it rises 
above a specified threshold. Check your audio software for a Compression or 
Dynamics feature. You can control attenuation by specifying a compression 
ratio. This turns down the loudest sections, and you can readjust input levels 
accordingly. 


Tip: For multipurpose dynamics compression, set the 
threshold to -10dB, the ratio to 4:1, and the attack and release 
times to 100ms. Adjust the input level to get approximately 
3dB of compression and an output level of about OdB. 


Equalization 


Equalization (EQ) changes the tone of the incoming signal by “boosting” 
(turning up) or “cutting” (turning down) certain frequencies. Using EQ, you 
can emphasize certain frequencies and cut others that contain noise or 
unwanted sound. EQ can compensate for RealAudio codecs that do not have 
flat frequency responses (that is, codecs for which certain frequencies are not 
as loud after encoding). You can therefore use EQ to make a RealAudio clip 
sound as close as possible to the source recording. 


Tip: For voice-only content, you can make the file more 
intelligible by cutting frequencies below 100 Hz and carefully 
boosting frequencies in the 1 to 4 kHz range. 
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CHAPTER 


5 


PRODUCING VIDEO 


RealVideo provides the highest quality compressed video available, 
whether for streaming or downloading. This chapter explains how 
RealProducer encodes a source video. It covers video production 
techniques, providing tips for capturing high-quality input and 
working with digitized video source files. This information will help 


you to produce high-quality clips. 


Understanding RealVideo 


A video consists of two parts: the visual track and the soundtrack. In a 
RealVideo clip, the soundtrack is encoded with RealAudio codecs, and the 
visual track is encoded with a RealVideo codec. RealProducer packages both 
tracks in a RealVideo clip that, like a RealAudio clip, uses the file extension 
.rm, .rmvb (variable bit-rate clip), or .rv (video file created by RealPlayer). The 
following sections explain the basic aspects of creating a RealVideo clip. 


Factors for Creating a Good Streaming Video 


The most important factor for creating a good streaming video is to start with 
good source material. The RealVideo encoding process does not improve the 
quality of the input, although filters can increase the visual contrast or remove 
certain imperfections. The more you compress video, the more its quality 
tends to degrade. So it’s important to understand how the encoding choices 
you make affect the clip’s final quality, and to follow good practices that keep 
the quality as high as possible throughout the video production cycle. 


Data Budgets 


As RealProducer converts a source video into a RealVideo clip, it compresses 
the video information so that the clip can stream at a certain bandwidth. 
Think of targeting a certain streaming audience as having a fixed data budget 
to spend. For low-bandwidth audiences such as users on 56 Kbps modems, 
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you have a smaller data budget (about 34 Kilobits a second) than when you 
target broadband audiences such as DSL and cable modem users (225 Kilobits 
or more per second). The following table lists some common target audiences, 
along with the maximum, recommended streaming speed (that is, your total 
data budget) for each. 


Maximum Streaming Rates 


Target Audience Maximum Streaming Rate 
14.4 Kbps modem 10 Kbps 

28.8 Kbps modem 20 Kbps 

56 Kbps modem 34 Kbps 

64 Kbps ISDN 45 Kbps 

112 Kbps dual ISDN 80 Kbps 

Corporate LAN 150 Kbps 


256 Kbps DSL/cable modem | 225 Kbps 
384 Kbps DSL/cable modem | 350 Kbps 
512 Kbps DSL/cable modem | 450 Kbps 
786 Kbps DSL/cable modem | 700 Kbps 


Video Quality Factors You Control Directly 


For a given data budget, you have to spend data on the following things, 
which are in your control: 


+ constant bit rate (CBR) or variable bit rate (VBR) encoding 


CBR clips, which are described in “Constant Bit Rate Video” on page 61, 
are the safer choice for streaming video to any bandwidth. Explained in 
“Variable Bit Rate Video” on page 64, VBR clips produce higher-quality 
results, but are suited only for video downloads and certain high- 
bandwidth streaming environments. 


audio soundtrack 


Most videos include a soundtrack that requires a fixed amount of 
bandwidth. If you give too much data to the soundtrack, the video’s visual 
quality suffers. Chapter 4 explains the RealAudio codecs used for 
RealVideo soundtracks. The section “Soundtrack Bandwidth” on page 55 
provides details about the bandwidth division between a video’s 
soundtrack and visual track. 
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- video dimensions 


You want to use the largest width and height for the video that you can. 
However, choosing too large of a video size takes too much data away 
from the other quality factors. The section “Video Capture” on page 69 
provides recommended dimensions. 


- video codec 


The RealVideo codec choice, and its encoding complexity level, also affect 
the clip quality. By default, RealProducer produces the best results by 
using the highest-quality codec set to the highest complexity level. 
However, you may want to choose different settings to speed encoding or 
reach older versions of RealPlayer. See “RealVideo Codecs” on page 60. 


Video Quality Factors You Affect Indirectly 


You do not set the following quality factors directly. Instead, other choices 
you make affect their outcomes in the encoded clip. In general, following good 
production practices and making smart choices with the factors that you can 
control result in good quality in these areas: 


- frame rate 


The frame rate affects how smoothly the motion flows in the video. If the 
frame rate encodes too low, the video will look jerky. For more on this, see 
“Encoded Frame Rates” on page 57. 


+ visual clarity 


If the visual quality comes out too low, the video will look fuzzy. For more 
information, see “Visual Clarity” on page 59. 


Soundtrack Bandwidth 


Because RealVideo uses RealAudio to encode a video’s soundtrack, a chunk of 
the clip’s bandwidth first goes toward the audio. The visual track is then 
squeezed into the bandwidth that’s left. For 56 Kbps modems, for example, 
RealVideo clips stream at 34 Kbps, leaving 22 Kbps of modem bandwidth for 
overhead. How much bandwidth the visual track gets depends on how the 
audio is encoded. With an 8 Kbps RealAudio voice codec for the soundtrack, 
the visual track gets 26 Kbps. With a 16 Kbps music codec, though, the visual 
track gets just 18 Kbps. 
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Possible Audio and Visual Tracks in a 56 Kbps RealVideo Clip 


56 Kbps 


22 K Overhead 22 K Overhead 


8 K Audio 


16 K Audio 


26 K Visual 
18 K Visual 


At low bandwidths, how you encode the soundtrack greatly affects how the 
visual track looks. Music codecs typically consume more bandwidth than do 
voice codecs. Music’s greater frequency range requires more data than does 
speech, so a music soundtrack consumes more bandwidth than a spoken one. 
A video with an audio narration might therefore look better than one 
accompanied by music, as there would be more bandwidth available for the 
visual track. 


At higher bandwidths, the soundtrack consumes proportionally less of the 
available clip data, so differences in soundtrack encoding affect visual quality 
less. At speeds above 100 Kbps, you get high-quality sound that uses no more 
than a quarter of the clip’s bandwidth. The following table lists the standard 
target audiences for constant bit rate RealVideo streams, giving the clip 
streaming speeds and the RealAudio codecs used for the soundtracks, broken 
out by audio type. 


Audio Codecs for Streaming RealVideo Clips 


Target Audience Clip Speed Voice Codec Music Codec 

28.8 Kbps modem ; ; ; 
6.5 Kbps voice | 8 Kbps Music - RealAudio 

56 Kbps modem 

64 Kbps single ISDN 8.5 Kbps voice | 11 Kbps Music - RealAudio 

128 Kbps dual ISDN 16 Kbps voice | 20 Kbps Music - RealAudio 


(Table Page 1 of 2) 
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Audio Codecs for Streaming RealVideo Clips (continued) 


Target Audience 
Corporate LAN 


Clip Speed Voice Codec 


256 Kbps DSL/cable 


32 Kbps voice 


Music Codec 


32 Kbps Stereo Music High 
Response - RealAudio 


44 Kbps Stereo Music High 
Response - RealAudio 


384 Kbps DSL/cable 


512 Kbps DSL/cable 


64 Kbps voice 


768 Kbps DSL/cable 


Encoded Frame Rates 


64 Kbps Stereo Music - 
RealAudio 


96 Kbps Stereo Music - 
RealAudio 


(Table Page 2 of 2) 


One way that RealProducer compresses clips is by reducing the input video’s 


frame rate. Each RealProducer audience has a frame rate target, typically 15 or 


30 frames per second (fps). Clips encoded at broadband rates usually meet 
their frame rate targets. At slower streaming speeds, RealProducer attempts to 


encode the target rate, but will scale the rate down as necessary depending on 


other factors such as video dimensions and audience bandwidth. So although 


you cannot control the frame rate precisely in these instances, using good 


production practices results in higher frame rates. 


Frame Rate and Motion 


The higher the frame rate, the smoother the motion will appear in the video: 


+ The standard frame rate for full-motion video is 24 to 30 fps. At this 


speed, the human eye perceives movement as continuous—a phenomenon 


known as persistence of vision. 


- Acommon rate for lower-speed streaming video that approximates full- 


motion video is 15 fps. To most people, a 15 fps video flows smoothly, 


though not quite as fluidly as one at a higher rate. 


+ Below 15 fps, a video looks jerky. 


+ Below 7 fps, a video looks very jerky. 


- Below 3 fps, a video essentially becomes a slideshow. 
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Factors that Affect Frame Rate 


Most source videos start out at 15 to 30 fps. During encoding, RealVideo 
adjusts this frame rate downward as necessary. Thus, your encoded clip will 
not have just one frame rate, but a mix of frame rates that varies with its 
content. If you follow good production practices, your clips will typically 
stream over slow- to medium-speed connections at 7 to 15 fps. At higher 
speeds, you'll get the 15 to 30 fps maximum set in the audience. Other factors 
besides bandwidth, though, affect a RealVideo clip’s frame rate: 


+ The video’s dimensions greatly affect frame rate. If the dimensions are too 
large for your target bandwidth, you will not get a high frame rate. For 
more information, see “Video Capture” on page 69. 


- RealVideo 10 provides video quality superior to that produced by older 
RealVideo codecs. Using an older codec may result in a lower frame rate. 


- Visually complex videos that show many objects moving across the screen 
simultaneously are hard to encode and may lower the frame rate. 


- RealProducer gives you an option for smoother motion. Choosing this 
option raises the clip’s overall frame rate but reduces visual quality. This 
has the most effect on clips that stream at low bandwidths. 


- In a video that has a mix of fast and slow scenes, variable bit-rate encoding 
(VBR) and two-pass encoding generally help the fast scenes achieve a 
higher frame rate. See “Variable Bit Rate Video” on page 64 and “Two-Pass 
Encoding” on page 78 for more information. 


+ During a live broadcast, RealProducer may lower the frame rate to speed 
the encoding time if the computer’s processing power is too low to encode 
the input in real-time. 


Scalable Video Technology 


RealVideo codecs include Scalable Video Technology (SVT), which affects 
playback, but has no effect on encoding. SVT scales down frame rates when 
clips play on slower computers. High frame rates take a lot of processing 
power to decompress. Although fast PCs handle high frame rates well, slower 
PCs may have trouble. With SVT, RealPlayer can lower the frame rate “on the 
fly” to keep a PC’s CPU from sputtering. So although a given scene is encoded 
at 15 fps, it may play on some RealPlayers at 8 fps if those computers lack the 
power to decompress 15 frames per second. 
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Visual Clarity 


In addition to lowering the frame rate, RealVideo compresses clips by 
throwing out pixel data. A video stores information about each pixel in the 
frame. RealVideo, on the other hand, stores data for pixel groups. When 
bandwidth is tight, RealVideo shoehorns pixels with slightly different RGB 
values into the same group. These pixels then look identical rather than nearly 
identical. This may result in a loss of detail if compression is too high. The 
following illustration compares a smooth video with one that has lost detail 
through too much compression. 


Smooth and Distorted Video 


Bandwidth is the primary factor that affects a clip’s visual clarity. By using 
good production practices as described in this chapter, you can help keep the 
video’s clarity intact during encoding. Also note the following points: 


+ The video’s dimensions affect visual clarity. Using dimensions too large 
for target bandwidth can make the video blurry. For more information, 
see “Video Capture” on page 69. 


- RealVideo 10 produces better visual clarity than RealVideo 9 or RealVideo 
8. 


+ When you encode with RealProducer, you can choose an option for better 
image quality. The video may be jerkier, though, because increasing the 
pixel data reduces the frame rate. This option has the most effect on clips 
that stream at low bandwidths. 


- A video with relatively stationary subjects (“talking heads”) will have 
better visual quality than a video with rapid scene changes and a lot of 
movement. 
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- VBR clips using two-pass encoding generally provide superior visual 
quality to CBR clips. See “Variable Bit Rate Video” on page 64 and “Two- 
Pass Encoding” on page 78 for more information. 


Tip: If you plan to launch a video in double- or full-screen 
mode, boost video clarity as much as possible during 
production and encoding. RealPlayer enlarges the clip by 
duplicating its pixels, which magnifies any defects. 


RealVideo Codecs 


RealVideo 10 is the default RealVideo codec used with RealProducer 10, but 
you can also encode with older RealVideo codecs. RealNetworks recommends 
using RealVideo 10 unless you need faster encoding performance during 
broadcasts, or you need to stream video to RealPlayer 8. 


For More Information: See also “Encoding Complexity Modes” 
on page 79 for information about how a video codec’s 
complexity mode affects video quality. 


RealVideo 10 Codec 


The RealVideo 10 codec creates the highest quality compressed video possible. 
It offers improved visual quality over RealVideo 9 and RealVideo 8, especially 
with fast-action scenes and on-screen text. Because RealVideo 10 performs 
more complex analysis of video data than earlier codecs, encoding may take 
more than twice the time required with RealVideo 9. To help shorten the 
encoding time and improve the quality of live broadcasts, RealProducer 
provides the following features: 


+ RealVideo 10 is optimized for multiprocessor machines. RealProducer 
uses a second processor when the video height is greater than 180 pixels. 
When you encode a SureStream CBR clip for multiple audiences, 
RealProducer uses up to two processors for each audience. For example, 
encoding a RealVideo clip for a 56 Kbps modem audience and a 256 Kbps 
broadband audience can utilize up to four processors. 


+ When encoding pre-recorded clips, you can lower the codec complexity 
level. This reduces the clip’s visual quality, but decreases the encoding 
time. For more information, refer to “Encoding Complexity Modes” on 
page 79. 
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+ For live broadcasts, RealProducer uses automatic load management 
features to compensate for the increased encoding demands of RealVideo 
10. This helps to ensure that RealProducer does not fall behind the video 
input rate. See “Broadcast Load Management” on page 174. 


RealVideo 10 is compatible with RealOne Player and later. Users of older 
RealPlayers are prompted to update to RealPlayer 10 when they attempt to 
play RealVideo 10 content. Playback of RealVideo 10 content consumes the 
same amount of system resources on the viewer’s computer as playback of 
RealVideo 9. Viewers, therefore, will not notice any performance slowdown 
when playing a RealVideo 10 clip compared to a RealVideo 9 clip. 


RealVideo 9 Codec 


RealVideo 9 improves on RealVideo 8 with higher compression and improved 
visual quality. RealOne Player and later can play RealVideo 9 clips. Users who 
have older versions of RealPlayer are prompted to autoupdate to RealPlayer 10 
when the viewer attempts to play a RealVideo 9 clip. 


RealVideo 8 Codec 


The RealVideo 8 codec is backwards-compatible to RealPlayer 8. The video 
quality is not as high as with RealVideo 9 and 10, but encoding is faster. 
Additionally, RealVideo 8 requires fewer resources on the RealPlayer machine 


to decompress. This makes it suitable for the slower processors of mobile, 
handheld devices. 


Constant Bit Rate Video 


When you create a RealVideo clip, you can choose constant bit rate (CBR) or 
variable bit rate (VBR) encoding. In RealProducer, each audience template is 
either CBR or VBR. CBR encoding is the more traditional method of encoding 
streaming video. It maintains a consistent bit rate for the stream, such as a 
constant 34 Kbps when streaming to 56 Kbps modems. You should generally 
use CBR video when streaming at bandwidths below 350 Kbps, and anytime 
you want to use SureStream to encode multiple bandwidths into the same clip 
or broadcast. At high bandwidths, however, you can use CBR or VBR video. 


SureStream CBR Clips 


Using SureStream technology, you can encode a constant bit rate RealAudio 
or RealVideo clip for multiple bandwidths. For example, you can encode a 
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single RealVideo clip for 56 Kbps modems, 112 Kbps dual ISDN, 256 Kbps 
DSL, and so on. The clip’s playback quality improves with each faster speed. 
When a viewer clicks a link to a SureStream clip, RealPlayer and Helix Server 
determine which stream to use based on the available bandwidth, as shown in 
the following illustration. 


SureStream Clip Encoded for Multiple Bandwidths 
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225 Kbps of Data 


Each stream that you add to SureStream clip increases the clip’s file size, as 
well as the encoding time. Streams for higher bandwidths increase the file size 
more than streams for lower bandwidth because high-bandwidth encodings 
include more data. As explained in “Broadcast Load Management” on page 
174, the encoding time can become a critical issue during live broadcasts, so 
you need to choose the audiences you use carefully. 


Note: The RealVideo codec you choose encodes all of a clip’s 
SureStream streams. You cannot encode half the streams with 
the RealVideo 10 codec, for example, and the other half with 
the RealVideo 8 codec. 


Downshifting and Upshifting 


Helix Server and RealPlayer can switch streams to compensate for network 
conditions. If a fast connection becomes bogged down because of high 
network traffic, Helix Server switches to a lower-bandwidth stream to prevent 
the presentation from stalling. When the congestion clears, Helix Server 
switches back to the higher-bandwidth stream. RealPlayer doesn’t need to 
rebuffer data during this shifting. 
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Switching Bandwidths During Network Congestion 
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Note: With the exception of the RealAudio lossless codec, all 
RealAudio codecs use constant bit rate encoding. Any audio 
stream other than a lossless stream can therefore be included 
in a SureStream clip, whether as a soundtrack to a video, or as 
audio-only voice or music. 


SureStream Substreams 


Because SureStream can downshift during network congestion, it’s a good 
idea always to include one or more substreams in a CBR clip. A substream is 
simply a stream encoded at a lower bandwidth than your target audience 
speed. RealProducer predefines three substream audiences, two for 28 Kbps 
modems and one for 56 Kbps modems: 


+ 12k Substream for 28k Dial-up 
+ 16k Substream for 28k Dial-up 
+ 26k Substream for 56k Dial-up 


Substreams are particularly important for modem users because modem 
bandwidth can fluctuate widely. For a 56 Kbps modem audience, the 56 Kbps 
modem template encodes video at 34 Kbps. If the SureStream clip includes 
the 26 Kbps substream, the video downshifts to that stream if the user’s 
available bandwidth falls below 34 Kbps. The clip can continue to downshift 
to slower substreams if needed. This ensures that the presentation can still 
stream during network congestion. 
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RealProducer labels certain audience templates as “substreams” because they 
are not intended to be the clip’s primary stream. Any CBR audience can act as 
a substream for a higher-bandwidth audience, however. You can include the 
64k Single ISDN audience as a substream for your 150k LAN users, for 
example, even if you do not intend to stream the clip over ISDN. To be 
effective, however, a substream should be no more than 100 Kbps slower than 
the primary audience. 


Variable Bit Rate Video 
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Variable bit rate (VBR) encoding generally provides superior video quality to 
constant bit rate (CBR) encoding. It gives more bandwidth to scenes that are 
hard to compress, making the most visible difference in videos that have fast- 
moving, high-action scenes. Clips encoded with VBR use the file extension 
.rmvb. VBR is not compatible with SureStream technology, however, so you 
can encode a VBR clip only for a single bandwidth. VBR encoding is suited for 
bandwidths of 350 Kbps or higher. 


Single Bit Rate for a VBR Clip 


Single Bit Rate 


RealMedia RealPlayer 


Unlike a CBR clip, a VBR clip does not maintain a constant streaming rate. 
Instead, it has a target average bit rate (or quality) and a maximum bit rate. 
For example, RealProducer’s 450 Kbps VBR download audience averages 450 
Kilobits of data per second. However, the audience has a maximum of 900 
Kbps, meaning that the stream can, if necessary, consume up to 900 Kilobits 
of data a second. These data spikes typically occur during high-action 
sequences, resulting in greater video clarity and higher frame rates than CBR 
encoding. 


Tip: In RealProducer, audience templates that use VBR 
encoding include “VBR” in the audience name. If the template 
does not say “VBR,” it is a CBR template. 


For More Information: Two-pass encoding is an important 
component for creating a high-quality VBR file. For more 
information, refer to “Two-Pass Encoding” on page 78. 
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VBR Clips for Download 


VBR clips are better suited for downloading than are CBR clips. Because a 
viewer downloads the entire clip before playing it, the bandwidth spikes 
inherent in a VBR clip will not cause playback problems. As you encode clips 
for download, you can consider the VBR encoding speeds as a guide to quality 
and file size. For example, a 450 Kbps VBR download will generally have lower 
quality and a smaller file size than a 750 Kbps VBR download. 


Tip: Quality depends on the source content. For a video that 
has relatively little action and small dimensions, for example, 
750 Kbps VBR encoding may offer little improvement over 450 
Kbps VBR encoding. 


VBR Clips for Streaming and Broadcasting 


Although VBR audience templates are geared for video downloads, you can 
also use VBR encoding for streaming clips and broadcasting live events. The 
primary reason to do this is that VBR offers better quality than CBR. For 
example, depending on the content, a 350 Kbps VBR stream may have roughly 
the same visual quality as a CBR stream encoded at 450 Kbps. 


To benefit from VBR, the streaming network must be able to accommodate 
bandwidth spikes. Local area networks (LANs) and cable modem users are 
good candidates for VBR streaming. Because all viewers in these networks 
share a large pool of bandwidth, a VBR clip’s intermittent bandwidth spikes 
tend not to overload a single viewer’s connection bandwidth. Connections in 
which bandwidth is not shared, such as DSL, can prove problematic. A 450 
Kbps VBR clip has a maximum bandwidth of 900 Kbps, for instance. If a DSL 
connection has a maximum throughput of 500 Kbps, the VBR clip may stall. 


When you stream a prerecorded VBR clip on demand, each viewer generally 
starts playback at a different time. This means that the bandwidth spikes 
inherent in the clip are spread out over time for all viewers. When you 
broadcast a VBR stream, however, bandwidth spikes occur for each viewer at 
the same time. When broadcasting, therefore, your network needs to handle 
higher cumulative spikes than when you stream prerecorded clips. 


Note: Streaming a VBR clip requires that you use Helix Server 
version 9 or higher. 
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Tip: Multicasting, which is available on some intranets, helps 
to overcome the bandwidth spikes of standard unicasting by 
delivering one stream to all viewers, rather than a separate 
stream to each viewer. For more information, refer to the 
multicasting chapter of Helix Server Administration Guide. 


VBR Encoding Settings 


For each VBR audience template, three settings affect how the clip or 


broadcast is encoded: maximum bit rate, average bit rate, and quality. Each 


VBR clip uses two of these three settings to determine how it encodes its data. 


To create a VBR clip appropriate for your needs, it’s important to understand 


how these settings interact. 


Average Bit Rate 


For More Information: The section “Creating and Editing 
Audiences” on page 153 explains how to change the VBR 
encoding settings through the graphical application. 


Tip: In an audience file, you can define two additional 
variations of VBR encoding, vbrUnconstrainedQuality and 
vbrUnconstrainedBitrate. For information about setting VBR 
properties through an audience file, refer to “Video Stream 
Properties” on page 341. 


A VBR clip’s average bit rate value reflects the average bandwidth of the clip 


measured as the total number of Kilobits consumed divided by the timeline in 


seconds. The actual bandwidth at any point during clip playback may be lower 


or higher than this value. Through most of the video, however, the second-by- 


second bandwidth use will be close to this value. 


Maximum Bit Rate 


A VBR clip’s maximum bit rate caps the bandwidth that the clip can consume. 
It is typically set by default to twice the average bit rate. A 450 Kbps VBR clip 


has a maximum bandwidth of 900 Kbps, for example. So during a high-action 


scene, for example, a video encoded with this audience may have a bandwidth 


spike of up to 900 Kbps. These spikes are only occasional, however, and the 


overall clip playback rate stays close to the average bit rate. 


66 


CHAPTER 5: Producing Video 


Although you can set the maximum bit rate value higher or lower, a higher 
setting is unlikely to result in significantly greater quality. You can lower the 
setting if you want to reduce the bandwidth spikes on your network. Keep in 
mind, however, that lowering this maximum decreases the benefit of VBR 
encoding. The closer the maximum bit rate value approaches the average bit 
rate value, the more the clip behaves like a CBR clip. 


Tip: Keep the maximum bit rate value between 50 percent to 
100 percent greater than the average bit rate setting. For a 450 
Kbps template, for example, the maximum rate should be 675 
to 900 Kbps. 


Quality 
The quality setting gears the encoding process to achieve a certain level of 
visual quality. With a quality of 100 percent, for example, RealProducer 
attempts to reproduce the visual quality of the input nearly perfectly. A lower 
quality, such as 90 or 80 percent, allows for more visual imperfections, but 
results in a smaller clip that uses less bandwidth. Keep in mind, however, that 
the quality setting does not guarantee a faithful reproduction of content. It 
only attempts to achieve the quality level within the input constraints, such as 
the video dimensions, target frame rate, content type, and maximum bit rate. 


Because encoding for quality can vary the average bit rate greatly, the average 
bit rate setting is ignored. (That is, the average bit rate and quality settings are 
mutually exclusive, and you can define only one of the values.) If you set a 
maximum bit rate of 900 Kbps and a quality of 100 percent, for example, the 
average bit rate may turn out to be close to 900 Kbps. At a lower quality target, 
such as 80 percent, the average bit rate will probably be lower. The actual, 
average bit rate depends greatly on content, though, and will vary for each 
clip. 

Because the average bit rate can vary greatly, quality-based encoding is better 
suited for downloaded clips. However, you can stream or broadcast a quality- 
encoded stream as long as your network has the capacity to provide to each 
user the bandwidth indicated by the maximum bandwidth target. Typically, 
each stream will use less bandwidth than this, and you can compute the 
average bandwidth of a clip by dividing the file size in Kilobits by the number 
of seconds in the timeline. For a live broadcast, though, it is impossible to 
know the average bandwidth of a quality-encoded stream in advance. 
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Tip: By editing an VBR audience file, you can vary the 
relationships between bit rate and quality. See “Stream 
Encoding Types” on page 342. 


Video Recording Tips 


If you intend to shoot a new video rather than use existing video content, this 
section provides tips for capturing high-quality input. Because video loses 
image quality if it’s highly compressed, always start with the best video source 
available. 


For More Information: For pointers on recording audio, see 
“Audio Capture” on page 48. 


Video Staging 


Consider the video’s final frame size before you shoot the first frame. 
Streaming over 56 Kbps modems requires a small video window, so you need 
to frame important visual elements well. For recommended clip dimensions, 
see “Video Encoding Dimensions” on page 71. 


Scene Changes and Movement 


The fewer things that change from frame to frame, the sharper the image will 
appear in a low-bandwidth video. You can do the following to cut down on 


unnecessary movement: 


+ Use a mounted camera rather than hand-held one. This greatly reduces 
the movement you inadvertently introduce into the scene when recording. 


+ Don’t have a rapidly moving object fill the entire frame. But you don’t 
want to pull the camera back too far either. You need to find a happy 
medium between close-ups and panoramic shots. 


Of course, you don’t want to eliminate all dynamic elements. When you do 
include rapid movement, allow enough time for objects to resolve. Because of 
low frame rates and high compression, objects coming to rest may appear 
blurry at first. If you have a dialog box popping up on a computer screen, for 
example, have the box remain stationary for a few seconds so that the image 
resolves. 
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Colors and Lighting 


Bright lighting at a constant exposure keeps the foreground detail crisp. Use 
uniformly dark colors for backgrounds, and uniformly light colors (but not 
whites) for clothing. Complex textures such as paisley and stripes degrade the 
final image quality with unwanted visual effects. 


Video Output 


Video playback devices commonly have at least two common output types— 
S-video and composite. Use S-video, as it produces better results. 
Professional-grade devices typically have other, high-quality output modes 
that can connect to a video capture card. 


Color Depth 


Always use 24-bit or 32-bit color. Lower color resolution results in poor clips. 


Source Media Quality 


Whether you shoot a video yourself or digitize existing material, start with 
high-quality video media. The following are common video formats, listed in 
order of descending quality: 


1. Betacam SP, also known simply as Beta. This format is common among 
video production professionals. 


2. DV, miniDV, DVCam, or DVCPro. 
3. Super-VHS (S-VHS) or HI-8mm. 
4. VHS, 8mm. 


Video Capture 


The following sections provide recommendations on frame rates and video 
dimensions when capturing video input into a digitized file, and encoding the 
video into a streaming or downloadable clip. When you encode directly from a 
capture source, you do not create an input file first. However, it is still 
important to choose your encoded output dimensions correctly to produce a 
high-quality clip or broadcast. 
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For More Information: See “Factors for Creating a Good 
Streaming Video” on page 53 for background on the 
relationship between dimensions, bandwidth, frame rate, and 
visual clarity. 


Video Capture Dimensions 


If you capture video to a digitized file format, such as AVI or MPEG, you can 
edit the video using video editing software before encoding it with 
RealProducer. In this case, digitize the video at 320 pixels wide by 240 pixels 
high unless you are short on disk space or your video capture card 
recommends different dimensions. 


Full-Screen Capture 


You may want to capture full-motion video at the full-screen size of 640 by 
480 pixels if all of the following are true: 


+ Your clips will stream at broadband speeds of 256 Kbps or higher. 
- Your encoded clips will be larger than 320 pixels by 240 pixels. 


- You have a video workstation capable of digitizing full-motion, full-screen 
video. Standard PCs typically cannot handle this large of a load. 


Video Capture Frame Rates 


When you capture content to a source file first, digitize the video at 15 frames 
per second (fps) if you plan to stream the clip at less than 150 Kbps. For these 
low speeds, 15 fps is the maximum rate that the standard RealProducer 
audiences encode. Above speeds of 150 Kbps, RealProducer can encode up to 
30 fps, so it is better to capture the source input at 30 fps. 


For More Information: For more information about the frame 
rate for encoded clips, see “Encoded Frame Rates” on page 57. 


Computer Speed and Disk Space 


Because video capture places a large burden on a computer’s CPU and hard 
drive, use the fastest computer you have available. On Windows computers, 
you can use any video capture card that supports Video for Windows or 
DirectShow. 
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Disk Space Requirements for Video Capture 
Use the following formula to calculate the approximate size in megabytes of a 
digitized video file: 
(pixel width) x (pixel height) x (color bit depth) x (fps) x (duration in seconds) 


8,000,000 


Suppose you want to capture a three-minute video at 15 frames per second, 
with 24-bit color, in a window that is 320 by 240 pixels. As you can see from 
the following equation, your digitized source file would be approximately 622 
MB: 


(320) x (240) x (24) x (15) x (180) / 8,000,000 = 622 Megabytes 


If necessary, you can conserve disk space by decreasing the clip dimensions or 
lowering the frame rate, or both. 


Video Source File Size Limit 


Some computer file systems limit a single file to 2 GB (2048 MB) in size. Ata 
320-by-240 size and 15 fps, this translates to about 9.5 minutes of video. 
Certain video production programs support the OpenDML (AVI 2.0) 
standard, which allows the creation of files larger than 2 GB. RealProducer 
may be able to accept a video source file larger than 2 GB as input, depending 
on the production software used to create the file. 


If you plan to produce long videos or videos with large dimensions, check 
whether or not your video production software is limited to a 2 GB output file 
size. If it is not limited to 2 GB, create a video file larger than 2 GB and test to 
determine if RealProducer can accept the file as input. 


Tip: If you are limited to 2 GB for the video source file and you 
need to produce a larger video, you can create separate video 
source files (each 2 GB or smaller) and encode them as separate 
RealVideo clips. Then, merge the clips using the RealMedia 
editor described in Chapter 12. 


Video Encoding Dimensions 


When you capture video to a digitized input clip, you want to capture the 
largest size possible to preserve as much quality as you can. When you encode 
the file as RealVideo, however, you may need to reduce the video dimensions. 
Choosing dimensions too large for a given target bandwidth can result in a 
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low frame rate or a large number of visual artifacts, rendering the video jerky 
or fuzzy. 


There are no specific rules for which video dimensions to use, other than to 
maintain the aspect ratio of the digitized source. The primary consideration 
for selecting encoding dimensions is bandwidth, though other factors can 
affect the quality. For example, to keep its frame rate higher, a fast-action clip 
may require smaller dimensions than a low-action clip. 


For More Information: To resize a video, you can scale the source 
file with your video editing software. Or, you can crop or resize 
the RealVideo clip as you encode it. For more on resizing, see 
“Resize Filter” on page 75. 


Desktop Video Dimension Recommendations 


Most videos encoded for streaming to a desktop media player use a 4:3 aspect 
ratio to fit the dimensions of standard computer monitors. The following are 
general recommendations for encoded video dimensions based on your target 
audience’s bandwidth: 


+ For desktop audiences with bandwidth less than 256 Kbps, use a smaller 
size, such as 240 pixels wide by 180 pixels highor 176 pixels wide by 132 
pixels high. 


Tip: RealVideo 10 provides higher quality at high compression 
rates than older RealVideo codecs. When developing video for 
low-bandwidth audiences, using RealVideo 10 provides higher 
quality at larger dimensions. 


+ For desktop broadband connections of 256 Kbps or higher, encode your 
clip at 320 pixels wide by 240 pixels high. 


+ At very high bandwidths, you can choose larger dimensions, such as 640 
by 480. To use these dimensions, however, the input should be of very 


high quality. 


Mobile Device Video Dimension Recommendations 


Mobile devices such as personal digital assistants and smartphones may have 
different screen sizes, so it’s useful to know the specifications for the devices 
you are targeting. A common screen resolution of most smartphones is 176 
pixels by 144 pixels. This size does not have the 4:3 aspect ratio common to 
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television and desktop video. If you are starting with a larger, 4:3 source such 
as 320 by 240, you can do two things: 


+ Reduce the video to 176 pixels wide by 132 pixels high. This leaves 12 
pixels of screen height unused. 


- If the input video width is 320 pixels, crop out portions from one or both 
sides to create a width of 292 pixels. Then scale the video smaller to 
approximately 176 pixels by 144 pixels. 


For More Information: For more about RealPlayer for mobile 
devices, visit http://www.realnetworks.com/industries/ 
mobile/index.html. 


High-Bandwidth and Low-Bandwidth Streaming Audiences 


If you want to encode a video clip or broadcast for both low-bandwidth and 
high-bandwidth audiences, you can adopt two different strategies: 


+ Use the same clip or broadcast for all audiences. 


Using SureStream technology, you can create a single RealVideo clip that 
streams at many bandwidths. However, if you create the video at a large 
size such as 320-by-240, the clip will not stream well to slow connections. 
Using a smaller size benefits modem users, but does not take full 
advantage of the greater bandwidth of faster connections. 


- Create separate clips for low-bandwidth and high-bandwidth viewers. 


Creating separate clips allows you to encode a larger clip for high- 
bandwidth audiences, and a smaller clip for low-bandwidth audiences. 
You can make the clips available through separate links, or use a SMIL 
<switch> tag to let RealPlayer choose which version to play. 


Note: Using a job file, you can encode two separate clips at 
once, sizing each clip separately. This allows you to create a 
larger clip for high-bandwidth audiences, and a smaller clip for 
low-bandwidth audiences in a single encoding pass. For more 
information, see “Media Profile” on page 324. 


For More Information: For information about using SMIL to 
select clips, refer to the switching chapter of RealNetworks 
Production Guide. 
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RealMedia File Size 


As noted in “Video Source File Size Limit” on page 71, file size limits imposed 
by an operating system’s file system are generally more of a problem when 
capturing video than when encoding it. A compressed RealVideo clip is often 
smaller than the input clip. However, there are some cases in which aa 
RealVideo clip may exceed the operating system’s maximum: 


- A SureStream clip, described in “SureStream CBR Clips” on page 61, can 
encode multiple streams for different audiences. If you include several 
high-bandwidth audiences, the encoded clip may exceed the source clip in 
size, even though each stream contains less data than the original input. 


- If you encode a long video clip directly from a live source or capture 
device, the encoded clip may grow larger than the allowable file system 
limit. 

When a clip reaches the operating system’s file size limit, RealProducer 
automatically creates, or rolls, a new clip. The new clip will have the same name 
as the original clip, but with a number added to the file name. For example, 
movie.rm rolls to movie1.rm when movie.rm reaches the operating system limit. 
The clip moviei.rm rolls to movie2.rm if it grows too large, and so on. 


For More Information: By using the command-line application 
or editing a job file, you can set lower limits on file rolling, and 
roll files by time, such as every 15 minutes. For job file 
information, refer to “File Destinations” on page 320. The 
command-line options are explained in “Output and 
Destination Options” on page 261. 


Tip: You can combine rolled files into a single sequence using a 
Ram file or a SMIL file. Transitions may not be seamless, and 
may contain audio and video gaps, however. For information 
about creating clip sequences, refer to Introduction to Streaming 
Media or RealNetworks Production Guide. 


RealVideo Filters 
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RealProducer includes video filters that can improve the appearance of the 
encoded clip. However, you should understand when to use each type of filter. 
Some filters can degrade the video quality when used incorrectly. As well, the 
use of some filters can significantly increase the encoding time. 
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For More Information: For information about using filters with 
the command-line application, refer to “Prefilter Options” on 
page 258. See “Prefilters” on page 307 for information about 
defining filters in the job file. 


Noise Filters 


A by-product of poor quality in one or more links in the video production 

chain, video noise (which has nothing to do with the audio quality) can distort 
the encoded clip. These distortions are similar to the “snow” that often shows 
up in TV signals received over an antenna. The source of the noise is typically 
hardware, such as the video tape, capture card, or camera. Using professional- 
quality equipment and media helps eliminate video noise at the source. If your 
source video is high quality to start with, you won’t need the noise filters. 


For More Information: The section “Video Noise” on page 95 
explains how to apply this filter using the graphical 
application. 


Low Noise Filter 


If your video input has a small amount of noise, turn on the low-noise filter. 
Because it has a small impact on processing power and won’t degrade a video’s 
appearance, the low noise filter is safe to leave on at all times. It’s better 
practice, though, to use it only when necessary. 


High Noise Filter 


If noise greatly distorts the source video, try the high noise filter. Use it only if 
necessary, though, because it can add 30% or more to the encoding time. The 
high noise filter can also remove slight details, making highly textured 
surfaces look more smooth, which may not be desirable in all cases. 


Resize Filter 


RealProducet’s resizing filter allows you to crop or resize the video as you 
encode it. You can select whether to do this as a fast resize or a high-quality 
resize. These resize options affect the video only when you make it smaller. 
The minimum size for a resized or cropped video is 32-by-32 pixels. The width 
and height of a resized or cropped video must be a multiple of 4, such as 160 
pixels, 240 pixels, and so on. 
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RealProducer can resize content using a quick method (fast resize), or through 
a complex analysis (high-quality resize). A fast resize has a small impact on 
encoding time, but the resulting image may have some distortion. A high- 
quality resize results in a superior image, but it may double or triple the 
encoding time because it carefully analyzes the video source before resizing. 
Because of its impact on speed, the high-quality resize filter is not 
recommended for broadcasts. 


Tip: If you are encoding a letterbox clip for display on 
computer screens that use a traditional 4:3 aspect ratio, crop 
out the black bars at the top and bottom of the video image. 
This helps to improve the video quality. 


For More Information: The sections “Cropping” on page 94 and 
“Resizing the Video” on page 98 explains how to crop and 
resize a video using the graphical application. 


Inverse-Telecine Filter 


The Inverse-Telecine filter is for cinematic film that was transferred to NTSC 
video, whether the VHS or BETA version. Film is usually photographed at 24 
frames per second (fps), whereas the NTSC standard is 30 fps. The film-to- 
video conversion (called “telecine”) duplicates some frames to bring the film 
input up to the NTSC frame rate. American theatre-release films transferred 
to video, for example, undergo the telecine process. 


Use the inverse-telecine filter when encoding NTSC video that was transferred 
from film and has a frame rate of 25 to 30 fps. (The filter is not necessary if 
the video frame rate is below 25 fps.) The filter strips out redundant frames, 
letting RealProducer focus on image quality. This improves the clip’s overall 
look. Although the inverse-telecine filter is safe to use on all input, it slows 
performance marginally and should be used only when the source is NTSC 
video that originated from film. 


Note: PAL video, which is widely used in Europe, does not 
require the inverse-telecine filter because the conversion from 
24 fps film to 25 fps PAL does not use the telecine process. 


For More Information: The section “De-Interlace and Inverse- 
Telecine” on page 95 explains how to apply this filter using the 
graphical application. 
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De-interlace Filter 


The de-interlace filter removes jaggedness in interlaced NTSC or PAL video. A 
video camera running at 30 frames per second captures the odd-numbered 
lines of a frame in 1/60th of a second, and the even-numbered lines in the next 
1/60th of a second. It then interlaces the two to create the frame. Because half 
the frame’s lines are captured a fraction of a second later than the other half, 
fast-moving objects may appear jagged, the result of the object advancing 
slightly within 1/60th of a second. The following figure illustrates this 
jaggedness in a detail of an interlaced video. 


Jaggedness in an Interlaced Video (detail) 


The next figure shows the jaggedness removed with the de-interlace filter. 


Jaggedness Removed with the De-interlace Filter (detail) 


The de-interlace filter has a modest impact on encoding speed, but is useful 
only for interlaced source video that is 240 lines or higher. Typical source 
video used for television is 480 lines high. If you digitize the video with a video 
capture card that captures at 240 lines high or less, the card throws out either 
the odd or the even lines, de-interlacing the video itself. The de-interlace filter 
is safe to leave on, though, because RealProducer never applies it to a video less 
than 240 lines high. 
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For More Information: The section “De-Interlace and Inverse- 
Telecine” on page 95 explains how to apply this filter using the 
graphical application. 


Black-Level Correction Filter 


The black-level correction filter improves a video’s contrast by making near- 
black pixels pure black and near-white pixels pure white. This improves the 
video’s appearance if it looks “washed out” because of a lack of contrast. Using 
this filter improves the RealVideo codec efficiency by increasing the number 
of pixels that have the same color value. Applying this filter has only a modest 
impact on encoding speed. 


For More Information: The section “Black-Level Correction” on 
page 95 explains how to apply this filter using the graphical 
application. 


RealVideo Options 
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The RealVideo options allow you to modify how RealProducer encodes 
RealVideo clips. You can generally change these options separate for each 
audience template. As with the RealVideo filters, you should understand how 
each options works before changing the default values. Setting an option 
incorrectly can degrade the video quality. 


Two-Pass Encoding 


With two-pass encoding, which is used only when encoding from a digitized 
source file, RealProducer runs through the entire source video once to gather 
information about how best to encode the streaming clip. It then makes a 
second pass to encode the streams. Two-pass encoding can substantially 
increase clip quality, but it requires more encoding time. The first pass takes 
about as long as it would to encode the source file for one target audience. 


Although two-pass encoding helps when you use constant bit rate encoding, it 
provides greater benefit for variable bit rate (VBR) encoding, described in 
“Variable Bit Rate Video” on page 64. With two pass encoding, RealProducer 
can analyze the entire video file to determine how best to vary the playback bit 
rate through the length of the clip. Without two-pass encoding, RealProducer 
sequentially analyzes small sections of the source file during encoding, 
creating a string of VBR sections within the clip. 
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Tip: Use two-pass encoding whenever you encode from a 
digitized file. Turn it off only if you must decrease the 
encoding time. When you use live input, RealProducer 
deactivates two-pass encoding automatically. 


For More Information: The section “Using Two-Pass Encoding” 
on page 97 explains how to disable two-pass encoding through 
the graphical application. See “Job Properties” on page 294 for 
information about setting this feature directly in the job file. 
The section “Disable Two-Pass Encoding (-dt)” on page 270 
explains how to override this feature using the command-line 
application. 


Encoding Complexity Modes 


RealProducer uses encoding complexity modes of low, medium, and high that 
affect the RealVideo 9 and RealVideo 10 codecs, as well as the RealAudio 
lossless codec. The default value of high produces the best possible results, but 
also requires the most processing, resulting in the longest encoding times. 
Lowering the complexity level to medium or low results in faster encoding 
times, but reduced visual quality (for video) or a larger file size (for lossless 
audio). 

With RealProducer Plus, the complexity mode for video encoding is user- 
definable for each audience template through the template’s advanced video 
options. You can also set the complexity for video or lossless audio through 
the command line, and capture the complexity setting to a job file. Note the 
following about the encoding complexity settings: 


+ RealVideo 10 set to the low encoding complexity is generally equivalent in 
quality and encoding time to RealVideo 9 set to the high encoding 
complexity. 


+ For live broadcasts, the load management feature reduces the encoding 
complexity automatically as needed, so you can keep the encoding 
complexity set to the default value of high. See “Broadcast Load 
Management” on page 174. 


+ The RealProducer 10 command-line application includes an -eco option 
that allows you to override the video or lossless audio encoding 
complexity mode selected in the audience file. See “Encoding Complexity 
Override (-eco)” on page 274. 
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+ The encoding complexity mode affects the file size and streaming rate of 
lossless audio clips. For details, refer to “Streaming Rates for Lossless 
Audio Clips” on page 47. 


For More Information: The section “Creating and Editing 
Audiences” on page 153 explains how to edit audience 
templates to change the RealVideo complexity mode. See 
“Video Stream Properties” on page 341 for information about 
setting this feature directly in the audience file. 


Video Startup Latency 


Each RealVideo clip has a maximum startup latency that determines how long 
video requires to display after RealPlayer begins to receive the stream. The 
default value of 4 ensures that the video requires no more than four seconds 
of buffering once the stream begins. This four second latency does not include 
the time it takes to launch RealPlayer, find the host Helix Server, send the 
request, and receive the server’s response, however. 


If necessary, you can increase the startup latency in whole values up to 60 
seconds. This may be particularly useful for videos that stream at low bit rates 
and start out with high action sequences. The longer latency creates a larger 
data buffer for the starting sequence, and generally improves the video’s 
appearance. Bear in mind, however, that a long latency time may cause restless 
viewers to stop the presentation before it begins playback. 


Note: The startup latency does not affect how quickly a 
downloaded clip begins to play. Increasing the latency value, 
however, can improve the visual quality in downloaded clips 
that begin with fast-action sequences. 


For More Information: The section “Creating and Editing 
Audiences” on page 153 explains how to edit audience 
templates to change this RealVideo option. See “Video Stream 
Properties” on page 341 for information about setting this 
feature directly in the audience file. 


Maximum Time Between Keyframes 


An uncompressed video records all data for each frame of the video. At 15 to 
30 frames per second, the amount of data quickly escalates to a very large file 
size. When creating a RealVideo clip, RealProducer encodes the full frame data 
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for only certain frames, called keyframes. The frames that follow a keyframe 
encode just the data that describes how that frame varies from the preceding 
frame. How often keyframes occur depend on the video contents. The first 
frame of a new scene typically requires a new keyframe. A fast-action video 
typically requires more keyframes than a slow-moving video. 


For More Information: The section “Creating and Editing 
Audiences” on page 153 explains how to edit audience 
templates to change this RealVideo option. See “Video Stream 
Properties” on page 341 for information about setting this 
feature directly in the audience file. 


Benefits of Lowering the Maximum Keyframe Time 


As an option for each audience template, you can set the maximum time 
between keyframes, which is 10 seconds by default for every audience 
template. This means that RealProducer adds a keyframe at least every 10 
seconds. Most videos will have more frequent keyframes than this anyway, 
depending on the video contents. Under most circumstances, you should not 
change this default value. You may want to lower it, though, to provide certain 
benefits. Adding more frequent keyframes does the following: 


+ Reduces distortion when streaming in a lossy environment. Distortion 
results when a frame packet is lost. Using more frequent keyframes helps 
to shorten the stretch of video that may be distorted. 


+ Reduces the video display latency during a live broadcast. For more 
information, refer to “Video Startup Latency on RealPlayer” on page 167. 


- Improves RealPlayer’s ability to seek to specific points in the RealVideo 
timeline. 


- Adds flexibility for editing RealVideo clips through the RealMedia editor. 
You can cut a RealVideo clip only at a keyframe, for example. Adding 


keyframes means more precise control over where the cut occurs. 


Costs of Lowering the Maximum Keyframe Time 


Because keyframes encode much more data than other frames, lowering the 
maximum time between keyframes can either increase the clip file size, or 
lower the clip’s image quality. In short, lowering the maximum keyframe rates 
provides more resilience against data loss, but degrades the overall 
compression efficiency. You should therefore change the keyframe rate only 
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after careful consideration and testing to determine if the change produces 
the desired results. 


Loss Protection 


RealProducer’s loss-protection feature adds error-correction data to RealVideo 
packets, helping them maintain quality when they are streamed in lossy 
environments. You'll get more benefit from loss protection when streaming 
across the Internet than over an intranet. The feature is turned off by default, 
but is safe to turn on for all encoded content because RealProducer adds only 
as much error-correction data as it can without lessening the video quality. 


Note: For most types of live broadcasts, RealProducer can also 
generate error correction packets to protect the stream as it is 
delivered to Helix Server. For more information, see “Forward 


Error Correction” on page 196. 


For More Information: The section “Creating and Editing 
Audiences” on page 153 explains how to edit audience 
templates to change this RealVideo option. See “Video Stream 
Properties” on page 341 for information about setting this 
feature directly in the audience file. 


CHAPTER 


6 


ENCODING CLIPS 


Using Jobs 


This chapter describes how to use the RealProducer graphical 
application to encode media clips. It explains how to define a job, 
choose audio and video inputs, set encoding options, and select 
encoding audiences. Chapter 7 provides details about each audience, 
and Chapter 8 explains how to start and monitor the encoding 


process. 


For More Information: You can also encode clips using the 
command-line application, which Chapter 14 describes. For 
instructions on sending an encoded stream to a server for 
broadcast, refer to Chapter 11. 


Each time you encode a clip or broadcast, RealProducer creates a job that 
records the encoding settings. The bottom portion of the RealProducer 
graphical application is a job manager that shows the current jobs, and allows 
you to perform actions with these jobs, such as running them in sequence. 


Optionally, you can save each job to a separate job file, which is an XML- 
formatted text file that you can manually edit as described in Appendix B. 
Once you have saved a job file, you can reload it to apply the same settings to 
another clip or broadcast. Although using a job file is optional, you'll find job 
files highly effective if you encode a lot of clips or broadcasts. 


Creating a New Job File 


Whenever you encode a clip or broadcast, RealProducer creates a job 
automatically, letting you choose whether or not to save the job settings to a 
file. You can also create a job file without actually encoding any streams. This 
allows you to define job profiles to use later. The following steps describe the 
basic procedure for creating, editing, and saving a job file. 
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> To create a new job: 


1. Start a new job file by choosing File>New Job or selecting an audio or 
video input to encode, as described in “Selecting Inputs and Destinations” 
on page 87. A new, untitled job appears in the job manager, which is 
described in “Using the Job Manager” on page 86. 


2. Define your encoding settings as described in this chapter. You can set up 
your audiences, define clip information, turn on video filters, create input 
and output file names, and so forth. 


3. If you use RealProducer Plus, you can save your job by choosing File>Save 
Job or pressing Ctrl+s. Or, close RealProducer Plus and click Save when 
prompted to save the job file. RealProducer Basic does not allow you to 
save job files. 


4. Using the Save dialog, save your job file anywhere on your computer or 
network. The job file is automatically saved with the file extension .rpjf. 


Tip: Give the job file a descriptive title that will help you to 
remember the purpose of the job. For example, you might 
name a job file GeneralVideoForDialUpModems.rpjf. 


Note: You can share a saved job by giving the job file to another 
RealProducer user. If you defined inputs and outputs, the user 
needs access to those same sources and destinations to run the 


job. 


Using and Modifying Existing Jobs 


Once you have saved a job file using RealProducer Plus, you can use it as the 
basis for additional encoding jobs. When you load a saved job file, you can 
override the job settings on a case-by-case basis. Suppose that a certain job file 
has all the basic settings you want, but for a certain clip you also want to turn 
on the video noise reduction filter. You just load the job file, turn on the noise 
reduction filter through the graphical application, and encode the clip. When 
you’re done, you can discard the changes, save them, or write the job to a new 
job file. 


Tip: RealProducer supplies a number of predefined job files 
that are stored in the samples/jobs subdirectory under the 
RealProducer main directory. You can use these files as 
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templates for your own jobs, or create your own jobs from 
scratch using the graphical user interface. 


» To open and modify an existing job file: 


1. If you have recently used the job you want to reuse, choose File>Recent 
Jobs>... and select from the list of jobs. Otherwise, give the File>OpenJob 
command and select the job file. 


2. Make any necessary changes, which may include the following: 


- If you defined inputs and outputs in the job file, RealProducer uses 
these same inputs and outputs. You can easily change this by deleting 
the input and output names and defining new ones, as described in 
“Selecting Inputs and Destinations” on page 87. 


+ It’s a good idea to double-check the audience settings for the job to 
ensure that you are encoding the output properly. For more 
information, see “Choosing Audiences” on page 98. 


- A job file can record specific clip information, as described in “Setting 
Basic Encoding Parameters” on page 95. You may need to add or 


change this information each time you encode with an existing job 
file. 


3. When you finish making necessary changes, choose File>Save Job (Ctrl+s) 
to save the changes to the existing job file. If you want to create a new job 
file, choose File>Save Job As... (Ctrl+Shift+s) and save the file under a new 
file name. 


Changing the Overall Default Settings 


RealProducer predefines many default settings, such as the audiences used. 
You can change the overall defaults to those set in the current job by choosing 
Settings> Default Settings>Save Current as Default. This is useful if you encode a 
lot of clips the same way. By saving your job settings as the default, you do not 
have to open a job file to use those settings. To restore the original, default 
settings, select Settings>Default Settings>Restore Original Default. 


For More Information: The section “Default Audiences and 
Options” on page 99 lists the audiences and encoding options 
used with the standard, default settings. 
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Running Multiple Jobs 


RealProducer Plus can run multiple jobs in batch mode, processing one 
output after another. Batch encoding is useful when you have a number of 
clips that you want to encode with similar settings. RealProducer Basic can 
open one job file at a time, however. 


>» To encode a batch of jobs: 


1. Open or create multiple jobs. Each job appears in the Job Manager, which 
is described in “Using the Job Manager” on page 86. 


Tip: To create a number of jobs with the same settings, open a 
job, then drag-and-drop media files into RealProducer. For 
each input file, RealProducer creates a new job with the same 
settings as the open job. You can also duplicate a job’s settings 
by right-clicking on a job title in the job manager and selecting 
Duplicate from the context menu. In this case, you may need to 
change the input and output clips. 


2. In the job manager, select the jobs that you want to encode. To do this, 
click each job while holding down the Ctrl key. You can also select a group 
of contiguous jobs by clicking the first job, then clicking the last job while 
you hold down the Shift key. 


Tip: To remove a job from the batch encoding run, highlight 
the job in the job manager and choose Edit>Delete. 


3. Encode the batch of jobs by clicking the Encode button. Each job runs in 
order. 


For More Information: For more about encoding and 
monitoring a job, refer to Chapter 8. 


Tip: You don’t have to wait for a job to finish encoding to 
perform other tasks with RealProducer. While one job runs, 
you can add a job or create a new job. 


Using the Job Manager 


The job manager, which appears at the bottom of the RealProducer main 
window, keeps track of the encoding jobs you are using in the current session. 
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Through this manager, you can quickly control more than one job at a time. 
The job manager display four information fields for each job: 


Job This is the job file name. Until you save the job file, the job name is 
Untitled. To change settings for a job, click its job name, then make your 
changes. 


Status This field provides a description of the job status, such as Ready, Not 
Ready, Analyzing, Encoding, and Done. 


Start This field indicates the time that the job began encoding. 


End This field records the time the job stopped encoding. 


Job Manager (detail) 


NarrovbandEncoding 


MobileDeviceEncoding Encoding (2nd Pass)...9% 


BroadbandEncoding 


olalelal —|J 


Tip: When you right-click a selected job in the job manager, 
RealProducer displays a context menu that allows you to 
perform basic functions with the job, such as starting the 
encoding, saving the job, and so on. 


Selecting Inputs and Destinations 


For the media input, you can use digitized files or data from an audio or video 
capture device. For outputs, you can specify an encoded clip, a live broadcast 
to a server, or both. Chapter 11 explains how to choose a server as a 
destination to create a live broadcast. 


For More Information: For information about acceptable audio 
and video input formats, refer to “Audio and Video Input 
Formats” on page 25. 


Using a File as the Input 


Source files are digitized media files on your hard disk, network, or input 
medium such as CD or DVD. If you have video editing software, you can use 
that software to edit and optimize the file before encoding it. 
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Tip: For tips about producing high quality input files, refer to 
“Audio Optimization” on page 50 and “Video Recording Tips” 
on page 68. 


> To use a digitized file as the encoding input: 


1. If you have multiple jobs open, click the appropriate job file name in the 
job manager. 


2. In the RealProducer main window, click the Input File radio button. Then 
click the Browse button to display a standard browsing dialog in which 
you can find the file you want to add as the input. You can also display the 
browsing dialog by giving the menu command File>Open Input File or the 
keyboard shortcut Ctrl+i. By default, the browse dialog shows only the 
media files that have acceptable input formats. 


Note: You cannot re-encode a RealMedia clip. If you need to 
encode a clip for a different audience, for example, you must 
use as input the original, digitized file. 


3. When you have located the input file through the browsing dialog, click 
Open. The field next to the Input File button displays the path and file 
name. If you have not already loaded a job file, an untitled job opens in 
the job manager. 


4. Once you have selected a source, you can click Source Properties to display 
information about the input, including the file size and duration, audio 
sampling rate and bit depth, and video dimensions and frame rate. 


Using Live Audio or Video as the Input 


Another source for media input is live or prerecorded audio or video sent to 
your computer’s audio or video capture card. You can encode these media 
inputs as clips, or send the encoded stream to a server for broadcast. 


> To capture from an audio device: 


1. If you have multiple jobs open, click the appropriate job file name in the 
job manager. 


2. In the RealProducer main window, click the Devices radio button. 


3. Select the audio capture device from the pull-down list. This list provides 
the names of all audio captures devices, such as “SoundBlaster,” that 
RealProducer has detected. 
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4. If you want to adjust the sound recording capabilities of your audio 
device, click the Settings button next to the listed audio device. A 
submenu lists the available settings dialogs, which may include vendor- 
specific controls that differ for each audio capture device. For instructions 


about using vendor-specific controls, consult the device’s user manual. 


5. Select the Recording Mixer menu option. This opens the recording control 
window in which you can specify how audio is mixed from different audio 
sources. 


6. Select which recording inputs to use by checking the Select box for each 
input. 


7. Adjust the sound level by moving the sliders up or down. When you have 
finished setting the values, close the recording control window. 


Tip: If the volume is too high, the recorded sound may be 
clipped and appear distorted. If the volume is too low, it will be 
difficult to hear. Use the audio meter described in “Monitoring 
Audio” on page 142 to monitor the level during encoding. 


8. If you want to encode the input for a specific amount of time, click the 
Duration box and enter the number of hours, minutes, and seconds in the 
timing fields. The timer begins when you start the encoding process, and 
automatically stops the process when the specified time elapses. 
Otherwise, encoding stops when you click the Stop button. 


9. Once you have selected a source, you can click Source Properties to display 
information about audio properties that will be captured. 
> To capture from a video device: 


1. If you have multiple jobs open, click the appropriate job file name in the 
job manager. 


2. In the RealProducer main window, select the Devices radio button. 


3. Select the video device for your computer from the pull-down list. This list 
provides the names of all video captures devices that RealProducer has 
detected. 


4. If you want to adjust the video recording capabilities, click the Settings 
button next video device name. This displays a submenu of available 
settings dialogs, which can vary with each capture device. For information 
about vendor-specific controls, consult the device’s user manual. 
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5. For most video capture devices, you can select the video dimensions in 
pixels. This will determine how large your input video will be. Select the 
same size you want for your encoded output clip. For more information, 
refer to “Video Encoding Dimensions” on page 71. 


6. Select the video format to determine how the capture card converts the 
video into digital video. Some common formats include RGB, YUY2, 
BTYUV, YUV9, and YUV12. 


Tip: Use YUV12 if it is available. This is the native color format 
for RealVideo codecs. Choosing this option improves 
performance by removing the need to convert the color format 
before encoding. 


7. Select the video source. Some video capture devices allow you to plug in 
various sources, such as an S-video input from a video camera, a cable 
television cable, or a Web camera. When you have finished setting the 
options, close the window. 


8. If you want to encode the input for a specific amount of time, click the 
Duration box and enter the number of hours, minutes, and seconds in the 
timing fields. The timer begins when you start the encoding process, and 
automatically stops the process when the specified time elapses. 
Otherwise, encoding stops when you click the Stop button. 


9. Once you have selected a source, you can click Source Properties to display 
information about video properties that will be captured. 


Creating a Destination Clip 


You can save your encoded output to a clip, as the following sections describe. 
Or, you can send the output to a server for broadcast as described in Chapter 
11. A clip or server output is called a destination, and you can save your encoded 
input to multiple destinations. For example, you send live input to a server for 
broadcast, and simultaneously write it to a clip for archive purposes. The 
encoded data sent to each destination is identical. 


Note: When you use RealProducer Plus, you can encode any 
number of clip and server destinations for the output. With 
RealProducer Basic, you can define one clip destination and 


one server destination in each job. 
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Tip: When you use a job file with the command-line 
application, you can specify multiple outputs, which can have 
different encoding settings. For example, one output might be 
a clip with large dimensions for broadband connections, while 
the second output is a clip with smaller dimensions for dial-up 
connections. See “Media Profile” on page 324 for more 
information. 


Modifying a Clip Destination 


By default, RealProducer automatically defines an output clip when you select 
an input file. The output clip uses the input’s base file name and the 
appropriate extension. For example, if you choose movie.mpeg as your input, 
RealProducer sets up movie.rm or movie.rmvb (depending on your encoding 
choices) as the output destination, creating the clip in the same directory as 
the input. 


To modify a clip’s properties, such as its name or output location, double-click 
the clip icon in the destinations area. You can also highlight the clip name, 
and click the pencil icon below the destinations window. Either action displays 
a browse dialog in which you can navigate to the directory where you want to 
save the clip. If you rename the clip, you can enter just the base file name. 
RealProducer appends the appropriate file extension (.rm for CBR clips or 
.rmvb for VBR clips), based on your encoding choices. 


For More Information: Through the RealProducer preferences, 
you can change the directory where the clip is created, or turn 
off the automatic destination feature. See “Changing the File 
Location Preferences” on page 149. 


Creating a New Destination Clip 


The following procedure describes how to create a new RealAudio or 
RealVideo clip as a destination for an encoded input file or live capture. It is 
generally necessary to encode just one destination clip. All destinations fora 
job have identical encoding settings. You can therefore create a second clip by 
duplicating the output clip through your operating system. 


> To define a clip as a destination: 


1. If you have multiple jobs open, click the appropriate job file name in the 
job manager. 
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2. Select File>Add File Destination. You can also click the RealPlayer icon in 
the destinations area. This opens a save dialog. 


3. Browse to the directory where you want to save the output clip. 


4. Enter the base file name. RealProducer automatically adds the correct file 
extension (.rm for CBR clips or .rmvb for VBR clips), based on your 
encoding choices. 


5. Click Save. Your new destination appears in the destinations area. If a 
destination already exists for the job, the new destination appear below it. 


Deleting a Destination Clip 


To delete a destination clip, select the job in the job manager if multiple jobs 
are open. Next, click the clip name in the destination window to highlight it. 
Then, either press Delete on your keyboard or click the trash can icon below 
the destination window. 


Adding Clip Information 
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RealProducer can encode clip information directly into a clip or broadcast. 
This is highly recommended for all jobs because the clip information tells the 
viewer about the stream and can help search engines categorize clip. If you are 
running multiple jobs, first choose the job you want by clicking the job name 
in the job manager. Then, either choose Settings>Show Clip Information or 
click the Clip Information button. You can then enter the following 


information: 

Title In this field, enter the title of the clip or broadcast. Because this title 
appears in the RealPlayer interface, it is best to use a short title. 

Author This field holds the name of the person or organization that created 
the clip. 

Copyright Here, enter the copyright string, such as (c) 2004 ABC Corporation. 

Keywords The keywords field holds words that certain audio and video search 


engines can read to categorize the clip. Add a few words that will help 
your audience search for your clip. Separate each term with spaces. 
Unless you are adding a proper name, use lowercase for each term. 
Avoid overly generic terms such as video or music. 
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Description This field holds a description of the clip that appears when the viewer 
displays extended clip information. This allows you to describe the 
clip in detail without creating a long title. 


Rating Selecting a rating in the pull-down list is highly recommended for any 
content not intended for all age groups. You can choose one of the 
following. No Rating is the default: 

-No Rating 

-All Ages 

-Older Children 

-Younger Teens 

-Older Teens (15 and up) 

-Adult Supervision Recommended 
-Adults Only 


Tip: Using the RMEvents utility described in Chapter 13, you 
can add information to a clip that has already been encoded. 
You can also specify clip information through a Ram file, as 
described in Introduction to Streaming Media. 


How Clip Information Displays in RealPlayer 


RealNetworks highly recommends that you always include a title. If a title is 
not encoded in the clip or specified through other means (such as a Ram file), 
RealPlayer displays the clip’s file name, which is of less use to the viewer than 
the title. The clip information appears in the following areas of RealPlayer: 


- The title appears in the title bar above the RealPlayer playback controls. 


+ Title and author information appears in the “Now Playing” list, which is 
part of the RealPlayer media browser pane. Viewers can double-click a clip 
title to play that clip. 


- Title information appears in the recent clips list at the bottom of the 
RealPlayer File menu. 


- Extended clip information appears when the viewer chooses File>Clip 
Properties>View Clip Info (Ctrl+i). 


Filtering Video Input 


When you encode video input, you can use a number of filters that can 
improve the quality of the video that comes from your source. All video filters 
are optional. If you are working with multiple jobs, select the appropriate job 
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in the job manager. Then, display the video filters palette by clicking the Video 
Filters button or selecting Settings>Show Video Filters (Ctrl+f). 


Video Filters 


Video Filters - Untitled 1 x| 


Source video dimensions: 240x180 


Lett [36 ={ Top [28 + 
Width: [168 +4 Height{124 =} 


Jv Black level correction 


|¥ Deinterlace / Inverse telecine 
(@ Automatic ( Manual: 


|v Video noise reduction: |Low v 


Tip: Changes to the video filters are recorded immediately. You 
do not need to close the palette to save your changes for the 
job. You can leave the palette open as you continue to set up a 
job or switch to another job. 


Cropping 


The cropping feature, available only on RealProducer Plus, allows you to crop 
out portions along the edge of a video. Cropping removes any unwanted areas, 
and can reduce the amount of data encoded, boosting clip quality. 


To crop a video, check the Cropping box. You can then set the cropping 
borders by clicking and dragging the yellow lines on the source video image. 
Or, enter cropping pixel values directly into the following boxes: 


Left Represents the number of pixels from the left edge of the video to start the 
cropping. You can specify up to 32 pixels less than the total width. 


Width Defines the total width of the cropped video, measured from the point set 
by the Left property. If the width value is not a multiple of 4, the next lower 
multiple is used. For example, a value of 162 results in a video 160 pixels 
wide. 


Top Sets the number of pixels from the top edge of the video to start the 
cropping. You can specify up to 32 pixels less than the total height. 


Height Indicates the total height of the video, measured from the point set by the 
Top property. If the value is not a multiple of 4, the next lower multiple is 
used. For example, a value of 127 results in a video 124 pixels high. 
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For More Information: You can scale a cropped or non-cropped 
video smaller or larger as described in “Resizing the Video” on 
page 98. Refer to “Video Encoding Dimensions” on page 71 for 
recommended video sizes. 


Black-Level Correction 


Check the Black level correction box to increase the video contrast by making 
black areas darker. This filter is useful if the source video appears washed out. 


De-Interlace and Inverse-Telecine 


The de-interlace and inverse-telecine filters remove artifacts that may occur in 
videos larger than 320-by-240, and NTSC-format video transferred from film, 
respectively. If you need to use them, click the Automatic radio button to have 
RealProducer apply the filters only if needed. To use just one of the filters, 
check the Manual button and select the filter you want. 


For More Information: The sections “De-interlace Filter” on page 
77 and “Inverse-Telecine Filter” on page 76 explain these filters. 


Video Noise 


Video noise appears as static (“snow”) in your input video. The noise filter 
removes these artifacts prior to encoding. Do not apply this filter if the input 
does not contain noise because the filter can degrade the quality of 
undistorted video. You can choose the Low setting if the static is light, or the 
High setting if it is more pronounced. 


For More Information: For more on the difference between low 
and high noise settings, refer to “Noise Filters” on page 75. 


Setting Basic Encoding Parameters 


When you create a new job, you should set a few basic parameters that affect 
the overall encoding. If you have multiple jobs open, select the appropriate job 
in the job manager as described in “Using the Job Manager” on page 86. After 
you set your input, click the Audiences button or choose Settings>Show 
Audiences (Ctrlt+e). This opens the Audiences palette. You set the basic 
parameters in the top half of the palette. In the bottom half, you select your 
audiences as described in “Choosing Audiences” on page 98. 
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Encoding Settings on Upper Half of Audiences Palette 


x 
Encoding Settings 
Audio mode: [Music | |v 2 ncoding (file to file only) 


Video mode: [Normal Motion Video y] Ve [160 | x [20 4 
width: height: 


Video codec: [RealVideo 10 | |¥ Maintain aspect ratio 


|v Use high quality resampler for audio Iv High quality resize 


Tip: Changes to the basic settings are recorded immediately. 

You do not need to close the palette to save your changes for 
the job. You can leave the palette open as you continue to set 
up a job or switch to another job. 


Setting Audio Parameters 


The Audio Mode setting indicates the type of audio being encoded: Voice, 
Music, or No Audio. You should ensure that this is set correctly for each job. For 
example, using the Voice setting for a musical soundtrack can degrade the 
music quality because a voice codec does not capture the wider frequency 
range found in music. 


In general, you should leave the Use high quality resampler for audio box 
checked. This provides the best results if the audio input does not have the 
correct sampling rate for the codec, as described in “Sampling Rate” on page 
36. Unchecking this box speeds processing time, which may be necessary 
during a live broadcast. Doing so may lower the quality of the audio, though. 


Tip: If your audio content is mixed, use the Music setting to 
capture the greatest frequency range. If you are encoding at a 
bit rate of 256 Kbps or higher, you may want to choose Music 
even for voice-only content. This generally provides more 
bandwidth for the soundtrack, improving the quality. It takes 
away bandwidth from the visual track, however. 
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Choosing Video Options 


The Video Mode pull-down list on the Audiences palette affects how video is 
encoded. The default value of Normal Motion Video produces the best results for 
most audiences. You can leave this value set even when you encode an audio- 
only clip because RealProducer automatically detects that no visual track is 
present. You should select the No Video option only if you want to encode just 
the audio portion from the video input. 


At slow streaming rates for modem audiences, you can choose one of the 
following options when encoding a video. These options primarily affect fast- 
action videos: 


+ Choose Sharpest Image if you want to encode the crispest image. The frame 
rate will be lower, though, making the video jerkier. For more 
information, see “Visual Clarity” on page 59. 


+ Choose Smoothest Motion if you want to keep the frame rate as high as 
possible. The image may become more blurry, however. For details, refer to 
“Encoded Frame Rates” on page 57. 


- If you have a large video (320-by-240 or larger), you can resize the video 
smaller when streaming at low bandwidths. Or, you can choose Slide Show 
to encode a frame every few seconds. This creates a slide show with no 
motion, but the highest possible image quality. 


Selecting a RealVideo Codec 


In the Video codec pull-down list, you select the RealVideo codec to use. The 
section “RealVideo Codecs” on page 60 explains the codec differences. The 
default is RealVideo 10, which provides the highest possible video quality and 
is compatible with RealOne Player and later. RealVideo 10 is the only option 
on RealProducer Basic. With RealProducer Plus, you can choose RealVideo 9 
or RealVideo 8. 


Tip: Use RealVideo 8 to create videos that are compatible with 
RealPlayer 8 and later on desktop machines, as well as with 
RealPlayer for mobile devices such as smartphones and 
personal digital assistants. 


Using Two-Pass Encoding 


In the Audiences palette, you can turn off two-pass encoding, which the 
section “Two-Pass Encoding” on page 78 describes. RealNetworks 
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recommends that you keep two-pass encoding enabled, turning it off only if 
you need to decrease your encoding time. Video quality will decline, however. 


Tip: Two-pass encoding cannot be used with live broadcasts 
and is automatically disabled. You therefore do not need to 
uncheck this option when broadcasting. 


Resizing the Video 


Normally, the encoded video uses the same height and width dimensions as 
the video input. If you use RealProducer Plus and you want to change the size 
of the encoded video, check the Resize video to box and enter a pixel value for 
the new height and width. You can scale the video smaller, which may be 
necessary when streaming to slow bandwidths, as described in “Video 
Capture” on page 69. Note that if you scale the output video much larger than 
the input size, it may appear blurry. 


If you keep the Maintain aspect ratio box checked, you can enter just the height 
or width value for the resize. RealProducer automatically calculates the other 
value to maintain the ratio between the two dimensions. By unchecking this 
box, you can enter width and height values independently. If you do not 
maintain the aspect ratio, however, the output will be distorted. 


RealNetworks recommends that you keep the High quality resize box checked. 
This produces superior results, but significantly increases the encoding time. 
Uncheck the box only if you need to decrease the encoding time. Note that the 
video quality will decline, however. The section “Resize Filter” on page 75 
provides background information about resizing. 


Note: You can also crop out portions of the video input before 
resizing the video. See “Filtering Video Input” on page 93 for 
more information. Refer to “Video Encoding Dimensions” on 
page 71 for recommended video sizes. 


Choosing Audiences 
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Before you encode a clip or broadcast, you choose the audience or audiences to 
use. For each audience, RealProducer encodes a separate stream based on the 
speed of the network connection or a certain level of quality that you want to 
preserve. For example, RealProducer encodes video at 34 Kbps for 56 Kbps 
dial-up modem users, and at 225 Kbps for 256 Kbps DSL or Cable Modem 
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users. RealProducer predefines a variety of audience templates. The following 
sections explain how to add audiences to encoding jobs. 


For More Information: Chapter 7 provides details about each 
audience that you can choose. See “Creating and Editing 
Audiences” on page 153 for information about creating your 
own audience templates. 


Default Audiences and Options 


If you do not choose your own audiences for an encoding job, RealProducer 
uses a set of default encoding values. On RealProducer Plus, these presets 
encode a clip or broadcast for streaming to both dial-up modems and 
broadband connections. The clip or broadcast will be compatible with 
RealOne Player and later. The following are the default values: 


General settings: | SureStream CBR clip for multiple audiences 
Two-pass encoding 
No predefined clip information 
Audiences: 16k Substream for 28k Dial-up 
28k Dial-up 
56k Dial-up 
256k DSL or Cable (RealProducer Plus only) 
Audio encoding: | Music codecs (codec used depends on the audience) 
High-quality audio resampling 
Video encoding: RealVideo 10 
Normal motion video 
No video resizing 
No video prefilters 
High encoding complexity 
Maximum start-up latency of 4 seconds 


Tip: The section “Changing the Overall Default Settings” on 
page 85 explains how to change these default settings. 


Adding an Audience to a Job 


If you have multiple jobs open, select the appropriate job in the job manager 

as described in “Using the Job Manager” on page 86. Then click the Audiences 
button or choose Settings>Show Audiences (Ctrl+e). This opens the Audiences 
palette. In the top half of this palette, you choose basic encoding settings as 
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described in “Setting Basic Encoding Parameters” on page 95. In the bottom 
half, you select your audiences. 


Audience Selection on Lower Half of Audiences Palette 


Audience Selection 
Templates Audiences in job: 4 (SureStream) 


Name fRatefQualty | 

256k DSL or Cable 

350k Download (VBR) 56k Dial-up 

350k Multichannel (VBR) 150k LAN 

350k Surround Stereo (VBR) 256k DSL or Cable 225 kbps 
384k DSL or Cable 

450k Download (VBR) 450 kbps 

450k Multichannel (VBR) 450 kbps 

450k Surround Stereo (VBR) 450 kbps 


The left-hand section of the Audiences palette lists the available audience 
templates. Each template has a name that describes the audience, such as 56k 
Dial-up, and lists the template’s average bandwidth usage. The right-hand 
section of the palette lists the audiences chosen for the job. By default, 
RealProducer uses the audiences described in the section “Default Audiences 
and Options” on page 99 to create a SureStream clip. 


To add an audience to the job, click the audience name in the left-hand 
windows and click the right arrow button. To add multiple audiences to the 
same job, you can choose only the audiences not listed as variable bit rate 
(VBR) audiences. To delete an audience from the job, highlight the template 
name in the right-hand section, and click the trash can icon or press your 
keyboard’s Delete key. 


Note: Using RealProducer Plus, you can add any number of 
CBR audiences to a SureStream clip. With RealProducer Basic, 
you are limited to three audiences. 


Tip: To view the properties for an audience added to the job, 
double-click the audience name. Or, highlight the name and 
click the pencil icon. Chapter 7 lists the properties for each 
audience. 
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CHOOSING AUDIENCES 


This chapter lists the properties of the predefined audiences. This 
information will help you to choose which audiences to use when 
encoding a clip or broadcast with the graphical application, as 
described in “Choosing Audiences” on page 98. You can also use 
audience files when encoding with the command-line application, 
which Chapter 14 explains. Appendix C describes the syntax of the 


audience files, which you can edit manually. 


Understanding Audiences 


A single audience defines a range of parameters used to encode a clip or 
broadcast. It defines the audio codecs, the video codec, the maximum frame 
rate, and the maximum streaming bandwidth, for example. You can use the 
same audience to encode a video clip or an audio-only clip. 


Audio Encoding for Audiences 


Each audience setting defines four possible audio codecs. RealProducer uses 
one of those codecs depending on the type of audio used as the input: 


+ For a voice-only audio clip, an audience uses a voice codec. If the input is 
stereo surround or 5.1 multichannel audio, however, it uses a stereo 
surround or multichannel music codec to preserve audio data in the extra 
channels. RealProducer uses this codec when the clip is audio-only and 
you select Voice as the audio mode. 


For a video with voice-only narration, an audience uses a voice, stereo 
surround, or multichannel codec as appropriate. Because a video clip uses 
the majority of its bandwidth for its visual track, RealProducer generally 
uses a lower-bandwidth audio codec than when it encodes an audio-only 
clip. RealProducer uses this codec with a video clip when you select Voice 
as the audio mode. 
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- For a music audio clip, an audience uses a mono music, stereo music, 
stereo surround, or 5.1 multichannel codec depending on the input and 
the streaming bandwidth. RealProducer uses this codec when the clip is 
audio-only and you select Music as the audio mode. 


« For a video with music, an audience uses a mono music, stereo music, 
stereo surround, or 5.1 multichannel codec depending on the input. The 
chosen codec is generally geared for a lower streaming speed than with a 
music-only clip, though, to preserve bandwidth for the visual track. 
RealProducer uses this codec with a video clip when you select Music as the 
audio mode. 


For More Information: The section “Setting Audio Parameters” 
on page 96 explains how to set the Voice or Music audio mode 
through the graphical application. For the command-line 
application, you use the -am option, described in the section 
“Audio Mode (-am)” on page 271. See “Media Profile” on page 
324 for information about how the stream context is set ina 
job file. 


Note: The audio codecs partially determine which versions of 
RealPlayer can play your clip or broadcast. The tables in this 
chapter summarize player compatibility. For specific 
information on a codec-by-codec basis, refer to “RealAudio 
Codecs” on page 35. 


Video Encoding for Audiences 


The audience defines a default video codec, which is RealVideo 10 for desktop 
streaming and download audiences, and RealVideo 8 for mobile device 
audiences. However, you can use RealVideo 8, 9, or 10 with any audience. To 
change the video codec choice, you can do one of the following: 


+ Edit the audience file manually as described in Appendix Cc. 


+ Override the codec default when encoding with the graphical-application, 
as described in “Selecting a RealVideo Codec” on page 97. 


- Override the codec default when encoding with the command-line 
application, as described in “Video Codec Override (-vco)” on page 273. 


Note: The video codec partially determines which versions of 
RealPlayer can play your clip or broadcast. The tables in this 
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chapter summarize player compatibility. For specific 
information on a codec-by-codec basis, refer to “RealVideo 
Codecs” on page 60. 


Which Audiences Should | Use? 


RealProducer provides a number of predefined audiences designed to fit a 
variety of streaming and downloading requirements. The following sections 
guide you to the appropriate set of audiences to use. As you explore the 
audience choices, keep two important points in mind: 


+ With variable bit rate (VBR) audiences, you can choose only one audience 
for each job. All audiences not marked as “VBR” are constant bit rate 
(CBR) templates. You can use multiple CBR audiences in a job. 


- As described in “Creating and Editing Audiences” on page 153, you can 
modify existing audiences or define your own audiences. Before doing 
this, however, verify that the predefined audiences do not meet your 
needs. You should also be familiar with the audio and video issues 
described in Chapter 4 and Chapter 5, respectively. 


Streaming to Low Bandwidth (Modem) Audiences 


The audiences described in “Low-Bandwidth Streaming Audiences” on page 
106 are designed to stream to low-bandwidth viewers, such as RealPlayer users 
connecting to the Internet through modems. Because these audiences are 
SureStream-compatible, you can encode several of them into a single clip. You 
can also add audiences from the set listed in “High-Bandwidth Streaming 
Audiences” on page 113. 


Creating Streaming or Downloadable Clips for Broadband Audiences 


The audiences described in “High-Bandwidth Streaming Audiences” on page 
113 are designed for broadband streaming connections such as digital 
subscriber line (DSL) and cable modems. Like the audiences described in 
“Low-Bandwidth Streaming Audiences” on page 106, these audiences are 
SureStream-compatible, so you can encode several of them into a single clip. 


For a downloadable clip, a VBR audience is the best choice. You can use VBR 
audiences for high-bandwidth streaming clips, too. However, you can choose 
only a single audience for each clip or broadcast when you use an audience 
listed in one of the following sections: 
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- The audiences described in the section “Variable Bit Rate Download 
Audiences” on page 120 create the most general-purpose clips. The audio 
will be encoded as mono or stereo, depending on the input. 


+ You can encode downloadable clips based on a quality metric by using the 
audiences listed in the section “Quality Download Audiences” on page 
125. These audiences also produce mono or stereo audio output. 


- The audiences described in “Stereo Surround Audiences” on page 129 
encode high-quality downloadable clips that preserve stereo surround 
information in the audio input. 


¢ Use the audiences listed in the section “Multichannel Audio Audiences” 
on page 133 to create downloadable clips from input that includes 
discrete, multichannel audio. 


+ For faithful encoding of standard mono or stereo input in audio-only 
clips, use the lossless codec described in “Lossless Audio” on page 138. 


Streaming or Downloading to Mobile Devices 


The audiences described in “Mobile Device Audiences” on page 117 are 
tailored to the needs of mobile devices such as smartphones and personal 
digital assistants. 


Low-Bandwidth Streaming Audiences 


This set of audiences encodes audio or video for streaming to RealPlayer 
across low-bandwidth Internet and intranet connections. Because these 
audiences are SureStream-compatible, you can encode multiple audiences into 
a clip, as explained in “SureStream CBR Clips” on page 61. That same clip can 
also contain one or more high-bandwidth audiences listed in the section 
“High-Bandwidth Streaming Audiences” on page 113. 


Substream Audiences 

The low-bandwidth streaming audiences include three substreams. These 
substreams are specifically intended as backups for dial-up modem audiences 
in cases where available bandwidth declines: 


+ 12k Substream for 28k Dial-up 
- 16k Substream for 28k Dial-up 
- 26k Substream for 56k Dial-up 
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You can choose any of the following audiences for your primary streams, or as 
backup streams for other higher-bandwidth, primary audiences: 


+ 28k Dial-up 

- 56k Dial-up 

+ 64k Single ISDN 
¢ 128k Dual ISDN 
«+ 150k LAN 


12k Substream for 28k Dial-up 


This audience is used as a substream for the 28k Dial-up audience. You can 
include it, along with the 16k Substream for 28k Dial-up, when encoding a 


SureStream clip for modem users. 


Setting or Property 


12k Substream Audience 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealPlayer G2 and later for audio-only voice or music 
Total bandwidth 12 Kbps 
Target video frame rate 15 fps 


Average video bandwidth 


6 or 7 Kbps depending on audio choice 


Recommended video sizes 176-by-132 
RealVideo codec RealVideo 10 
SureStream compatible yes 
Recommended substreams none 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music 


Voice codec for video 


5 Kbps voice 


Music codec for video 


6 Kbps Music - RealAudio 


Voice codec for audio-only 


8.5 Kbps voice 


Music codec for audio-only 


11 Kbps Music - RealAudio 
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16k Substream for 28k Dial-up 


This audience is a substream for the 28k Dial-up audience. You can include it, 
along with the 12k Substream for 28k Dial-up, when encoding a SureStream 
clip for modem users. 


16k Substream Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealPlayer G2 and later for audio-only voice or music 
Total bandwidth 16 Kbps 
Target video frame rate 15 fps 


Average video bandwidth 


10 or 11 Kbps depending on audio choice 


Recommended video sizes 176-by-132 
RealVideo codec RealVideo 10 
SureStream compatible yes 


Recommended substreams 


12k Substream for 28k Dial-up 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music 


Voice codec for video 


5 Kbps voice 


Music codec for video 


6 Kbps Music - RealAudio 


Voice codec for audio-only 


16 Kbps voice 


Music codec for audio-only 


16 Kbps Music - RealAudio 


26k Substream for 56k Dial-up 
This is a substream for the 56k Dial-up audience. 


26k Substream Audience 


Setting or Property Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 


RealPlayer G2 and later for audio-only voice or music 


Total bandwidth 26 Kbps 


Target video frame rate 15 fps 


Average video bandwidth 18 or 19 Kbps depending on audio choice 


(Table Page 1 of 2) 
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26k Substream Audience (continued) 


Setting or Property 


Value 


Recommended video sizes 


176-by-132 to 240-by-180 


RealVideo codec 


RealVideo 10 


SureStream compatible 


yes 


Recommended substreams 


16k Substream for 28k Dial-up 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music 


Voice codec for video 


6.5 Kbps voice 


Music codec for video 


8 Kbps Music - RealAudio 


Voice codec for audio-only 


16 Kbps voice 


Music codec for audio-only 


28k Dial-up 


20 Kbps Music - RealAudio 
(Table Page 2 of 2) 


The 28 Kbps dial-up audience is the primary audience for users connecting to 


the Internet on 28.8 Kbps modems. 


Setting or Property 


28k Dial-up Audience 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealPlayer G2 and later for audio-only voice or music 
Total bandwidth 20 Kbps 
Target video frame rate 15 fps 


Average video bandwidth 


12 or 13 Kbps depending on audio choice 


Recommended video sizes 176-by-132 
RealVideo codec RealVideo 10 
SureStream compatible yes 


Recommended substreams 


12k Substream for 28k Dial-up, 16k Substream for 
28k Dial-up 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music 


Voice codec for video 


6.5 Kbps voice 


Music codec for video 


8 Kbps Music - RealAudio 
(Table Page 1 of 2) 
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28k Dial-up Audience (continued) 


Setting or Property 


Value 


Voice codec for audio-only 16 Kbps voice 


Music codec for audio-only 20 Kbps Music - RealAudio 


56k Dial-up 


(Table Page 2 of 2) 


The 56 Kbps dial-up audience is the primary audience for users connecting to 


the Internet on 56 Kbps modems. This audience setting encodes stereo music 
for an audio-only clip. Lower-bandwidth substreams, such as the 26k 
Substream for 56k Dial-up, encode all audio output as mono. So if a 56 Kbps 


modem user is listening to a stereo music clip, a drop in bandwidth causes a 


shift to mono music. 


56k Dial-up Audience 


Setting or Property Value 
Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealPlayer G2 and later for audio-only voice or music 
Total bandwidth 34 Kbps 


Target video frame rate 


15 fps 


Average video bandwidth 


26 or 27 Kbps depending on audio choice 


Recommended video sizes 


176-by-132 to 240-by-180 


RealVideo codec 


RealVideo 10 


SureStream compatible 


yes 


Recommended substreams 


26k Substream for 56k Dial-up, 16k Substream for 
28k Dial-up 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music with video, stereo music for 
audio-only 


Voice codec for video 


6.5 Kbps voice 


Music codec for video 


8 Kbps Music - RealAudio 


Voice codec for audio-only 


32 Kbps voice 


Music codec for audio-only 


32 Kbps Stereo Music High Response - RealAudio 


64k Single ISDN 
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This is the primary audience for single-line ISDN. Although DSL lines and 


cable modems are replacing ISDN use in many countries, this audience can act 
as a substream for higher-bandwidth encodings. 


Setting or Property 


64k Single ISDN Audience 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealPlayer G2 and later for audio-only voice or music 
Total bandwidth 50 Kbps 
Target video frame rate 15 fps 


Average video bandwidth 


39 or 41 Kbps depending on audio choice 


Recommended video sizes 


176-by-132 to 240-by-180 


RealVideo codec 


RealVideo 10 


SureStream compatible 


yes 


Recommended substreams 


56k Dial-up, 26k Substream for 56k Dial-up 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music with video, stereo music for 
audio-only 


Voice codec for video 


8.5 Kbps voice 


Music codec for video 


11 Kbps Music - RealAudio 


Voice codec for audio-only 


32 Kbps voice 


Music codec for audio-only 


44 Kbps Stereo Music High Response - RealAudio 
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128k Dual ISDN 


This is the primary audience for dual-line ISDN. Although DSL lines and 
cable modems are replacing ISDN use in many countries, this audience can act 


as a substream for higher-bandwidth encodings. 


Setting or Property 


128k Dual ISDN Audience 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealPlayer 8 and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 
Total bandwidth 100 Kbps 


Target video frame rate 


15 fps 


Average video bandwidth 


79 or 84 Kbps depending on audio choice 


Recommended video sizes 


176-by-132 to 240-by-180 


RealVideo codec 


RealVideo 10 


SureStream compatible 


yes 


Recommended substreams 


64k Single ISDN, 56k Dial-up 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music with video, stereo music for 
audio-only 


Voice codec for video 


16 Kbps voice 


Music codec for video 


20 Kbps Music - RealAudio 


Voice codec for audio-only 


64 Kbps voice 


Music codec for audio-only 


96 Kbps Stereo Music - RealAudio 


150k LAN 
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This audience is designed for a local area network (LAN) such as a corporate 


intranet. This is the lowest-speed audience that uses stereo music for video 


soundtracks, and that can encode more than 15 frames of video per second. 


Setting or Property 


150k LAN Audience 


Value 


Player compatibility 


RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 


Total bandwidth 150 Kbps 
Target video frame rate 30 fps 
Average video bandwidth 118 Kbps 


Recommended video sizes 


176-by-132 to 240-by-180 


RealVideo codec 


RealVideo 10 


SureStream compatible 


yes 


Recommended substreams 


128k Dual ISDN, 64k Single ISDN 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, stereo music 


Voice codec for video 


32 Kbps voice 


Music codec for video 


32 Kbps Stereo Music High Response - RealAudio 


Voice codec for audio-only 


64 Kbps voice 


Music codec for audio-only 


128 Kbps Stereo Music - RealAudio 10 


High-Bandwidth Streaming Audiences 


This set of audiences encodes audio or video for streaming to RealPlayer 


across broadband Internet connections. Use any of the following audiences, or 


a combination of several audiences, to create general-purpose clips that 


stream at high bandwidths: 


+ 256k DSL or Cable 
+ 384k DSL or Cable 
+ 512k DSL or Cable 
« 768k DSL or Cable 
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Note: Because these audiences are SureStream-compatible, you 


can also encode in the same clip the audiences listed under 


“Low-Bandwidth Streaming Audiences” on page 106. A single 


clip for narrowband and broadband streams works well for 


audio-only clips. With video, however, you may want to use 


different width and height dimensions for low-speed and high- 


speed audiences. For more information, refer to “Video 


Capture” on page 69. 


Tip: Although you can also use these audiences when creating 


clips intended for download, the audiences described in the 


section “Variable Bit Rate Download Audiences” on page 120 


are better suited for this purpose. 


256k DSL or Cable 


This audience targets 256 Kbps DSL and cable modem users. This is typically 


the lowest speed at which these services are offered. 


Setting or Property 


Player compatibility 


256k DSL or Cable Audience 


Value 


RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 


Total bandwidth 


225 Kbps 


Target video frame rate 


30 fps 


Average video bandwidth 


180 or 193 Kbps depending on audio choice 


Recommended video sizes 320-by-240 
RealVideo codec RealVideo 10 
SureStream compatible yes 


Recommended substreams 


150k LAN, 128k Dual ISDN 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, stereo music 


Voice codec for video 


32 Kbps voice 


Music codec for video 


44 Kbps Stereo Music High Response - RealAudio 
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256k DSL or Cable Audience (continued) 


Setting or Property 


Value 


Voice codec for audio-only 64 Kbps voice 


Music codec for audio-only 256 Kbps Stereo Music - RealAudio 10 


384k DSL or Cable 


(Table Page 2 of 2) 


This audience targets 384 Kbps DSL and cable modem users. It provides the 
highest-quality, audio-only encoding for a general streaming audience. 
Higher-speed audiences improve the video and audio-with-video quality, but 
will have the same audio-only quality. 


Setting or Property 


384k DSL or Cable Audience 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 

Total bandwidth 350 Kbps 

Target video frame rate 30 fps 

Average video bandwidth 286 Kbps 

Recommended video sizes 320-by-240 

RealVideo codec RealVideo 10 

SureStream compatible yes 


Recommended substreams 


256k DSL or Cable, 150k LAN 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


64 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music 


Music codec for audio-only 


320 Kbps Stereo Music - RealAudio 10 
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512k DSL or Cable 


This audience targets 512 Kbps (one-half Megabit) DSL and cable modem 
users. The music-with-video quality is better than the 384k DSL or Cable 
audience, but the audio-only quality is the same. 


Setting or Property 


512k DSL or Cable Audience 


Value 


Player compatibility 


RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 


Total bandwidth 


450 Kbps 


Target video frame rate 


30 fps 


Average video bandwidth 


353 or 386 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


yes 


Recommended substreams 


384k DSL or Cable, 256k DSL or Cable 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music 


Music codec for audio-only 


320 Kbps Stereo Music - RealAudio 10 


768k DSL or Cable 


This audience targets 768 Kbps (three-quarters Megabit) DSL and cable users. 
For audio-only encoding, the audio quality is the same as the 384k DSL or 
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Cable audience. With video, the audio quality is the same as the 512k DSL or 


Cable audience. 


Setting or Property 


768k DSL or Cable Audience 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 

Total bandwidth 700 Kbps 

Target video frame rate 30 fps 


Average video bandwidth 


603 or 646 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


yes 


Recommended substreams 


512k DSL or Cable, 384k DSL or Cable 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music 


Music codec for audio-only 


Mobile Device Audiences 


320 Kbps Stereo Music - RealAudio 10 


The mobile device audiences are designed for streaming media to 


smartphones that include RealOne Player (or later) for mobile devices, as well 


as for creating download clips for personal digital assistants such as Palm 


devices and Pocket PC. These audiences have two features meant to 


accommodate the slower processors on these devices: 


- The maximum frame rate for these audiences is lower than the frame rate 


for other streaming and download audiences. Decoding a high frame rate 


is processor-intensive. A lower frame rate is therefore recommended for 


mobile devices. 


+ RealVideo 8 is the preferred codec. It requires less processor power for 
decompressing video than RealVideo 9 and RealVideo 10. 
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Warning! When you encode with the graphical application, you 
will override the RealVideo 8 codec selection if you do not 
change the job’s default setting from RealVideo 10. See 
“Selecting a RealVideo Codec” on page 97. 


When encoding a destination, you can choose one of the following mobile 
device audiences: 

+ General Mobile Streaming Audience 

+ General Mobile Local Playback Audience 

* Pocket PC Local Playback Audience 


General Mobile Streaming Audience 
This audience is designed for streaming audio or video to smartphones. 


General Mobile Streaming Audience 


Setting or Property Value 

Player compatibility RealOne Player and later for mobile devices 
Total bandwidth 20 Kbps 

Target video frame rate 5 fps 

Average video bandwidth 12 or 14 Kbps depending on audio choice 
Recommended video sizes 176-by-144 

RealVideo codec RealVideo 8 

SureStream compatible yes 

Recommended substreams n/a 

Audio input mono or stereo voice or music 

Audio output mono voice or music 

Voice codec for video 6.5 Kbps voice 

Music codec for video 8 Kbps Music - RealAudio 

Voice codec for audio-only 16 Kbps voice 

Music codec for audio-only 16 Kbps Music - RealAudio 
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General Mobile Local Playback Audience 


This general-purpose audience produces audio or video clips suitable for 
download to most mobile devices. 


General Mobile Local Playback Audience 


Setting or Property 


Player compatibility 


Value 


RealOne Player and later for mobile devices 


Total bandwidth 


80 Kbps 


Target video frame rate 


7.5 fps 


Average video bandwidth 


64 to 72 Kbps depending on audio choice 


Recommended video sizes 176-by-144 
RealVideo codec RealVideo 8 
SureStream compatible yes 
Recommended substreams n/a 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music with video, stereo music for 
audio-only 


Voice codec for video 


16 Kbps voice 


Music codec for video 


16 Kbps Music - RealAudio 


Voice codec for audio-only 


32 Kbps voice 


Music codec for audio-only 


44 Kbps Stereo Music 


Pocket PC Local Playback Audience 


This audience is suitable for audio or video clips downloaded to Pocket PC 
devices or any other mobile device with a higher-speed processor. 


Pocket PC Local Playback Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later for mobile devices 
Total bandwidth 200 Kbps 

Target video frame rate 15 fps 

Average video bandwidth 168 Kbps 

Recommended video sizes 176-by-144 


RealVideo codec 


RealVideo 8 
(Table Page 1 of 2) 
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Pocket PC Local Playback Audience (continued) 


Setting or Property Value 
SureStream compatible yes 
Recommended substreams n/a 


Audio input 


mono or stereo voice or music 


Audio output 


mono voice, mono music with video, stereo music for 
audio-only 


Voice codec for video 


32 Kbps voice 


Music codec for video 


32 Kbps Music High Response - RealAudio 


Voice codec for audio-only 


32 Kbps voice 


Music codec for audio-only 


64 Kbps Stereo Music 
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This set of audiences encodes downloadable clips. You can also encode 
streaming clips or broadcasts using these audiences, as long as you 
understand the streaming characteristics described in “Variable Bit Rate 
Video” on page 64. For each job, you can choose one of the following VBR 


download templates: 
+ 350k Download ( 
« 450k Download ( 
« 1M Download (VBR) 
+ 2M Download (VBR) 
« SM Download (VBR) 


VBR) 
VBR) 
« 750k Download (VBR) 


Tip: If you are unsure about your network characteristics, stick 
with the audiences described in “High-Bandwidth Streaming 
Audiences” on page 113. Those audiences encode video at a 


lower quality, but make more conservative assumptions about 
available bandwidth. 


For More Information: You can also create downloadable clips 
according to a quality metric. The section “Quality Download 
Audiences” on page 125 lists the audiences that you use for 
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this type of encoding. If your audio input is not mono or 


stereo, you may want to use a stereo surround or multichannel 


audience as described in “Stereo Surround Audiences” on page 
129 and “Multichannel Audio Audiences” on page 133. 


350k Download (VBR) 


This is the lowest-speed VBR download audience. 


350k Download (VBR) Audience 


Setting or Property 


Player compatibility 


Value 


RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 


Average bandwidth 350 Kbps 
Maximum bandwidth 700 Kbps 
Target video frame rate 30 fps 

Average video bandwidth 286 Kbps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


64 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


320 Kbps Stereo Music - RealAudio 10 
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450k Download (VBR) 


This audience offers improved music-with-video quality from the 350k 
Download (VBR) audience. Higher-speed audiences improve the video quality 
but not the audio quality. 
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450k Download (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 
Average bandwidth 450 Kbps 


Maximum bandwidth 


900 Kbps 


Target video frame rate 


30 fps 


Average video bandwidth 


353 to 386 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


320 Kbps Stereo Music - RealAudio 10 
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750k Download (VBR) 


This audience provides the same audio quality as the 450k Download (VBR) 
audience. 


750k Download (VBR) Audience 


Setting or Property 


Player compatibility 


Value 


RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 


Average bandwidth 


750 Kbps 


Maximum bandwidth 


1500 Kbps 


Target video frame rate 


30 fps 


Average video bandwidth 


654 to 686 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


320 Kbps Stereo Music - RealAudio 10 


1M Download (VBR) 


With this audience, audio quality is the same as with the 450k Download 
(VBR) and 750k Download (VBR) audiences. 


1M Download (VBR) Audience 


Value 


Setting or Property 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 
Average bandwidth 1 Mbps 
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1M Download (VBR) Audience (continued) 


Setting or Property Value 
Maximum bandwidth 2 Mbps 
Target video frame rate 30 fps 


Average video bandwidth 


904 to 936 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


2M Download (VBR) 


320 Kbps Stereo Music - RealAudio 10 
(Table Page 2 of 2) 


This audience offers very high download quality for large video clips. 


Setting or Property 


2M Download (VBR) Audience 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 

Average bandwidth 2 Mbps 

Maximum bandwidth 4 Mbps 

Target video frame rate 30 fps 

Average video bandwidth 1936 Kbps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 
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2M Download (VBR) Audience (continued) 


Setting or Property 


Music codec for video 


Value 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


5M Download (VBR) 


320 Kbps Stereo Music - RealAudio 10 
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This audience provides very high-quality playback for large video clips. 


Setting or Property 


5M Download (VBR) Audience 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 

Average bandwidth 5 Mbps 

Maximum bandwidth 10 Mbps 

Target video frame rate 30 fps 


Average video bandwidth 


4904 to 4936 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


Quality Download Audiences 


320 Kbps Stereo Music - RealAudio 10 


The quality download audiences are similar to the VBR audiences described in 


“Variable Bit Rate Download Audiences” on page 120. You can use them if you 


wish to maintain a certain visual quality level in large, downloadable video 


clips. Because these audiences do not define an average bit rate, they are not 
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good choices for streaming. When encoding a destination, you can choose one 
of these VBR quality download templates: 


+ 70% Quality Download (VBR) 
+ 80% Quality Download (VBR) 
+ 90% Quality Download (VBR) 
+ 100% Quality Download (VBR) 


For More Information: For background on the difference 
between VBR clips encoded for quality or bit rate, refer to “VBR 
Encoding Settings” on page 66. 


Note: All quality-based download audiences provide the same 


audio quality, so you will notice quality improvements among 


the templates only with video clips. 


70% Quality Download (VBR) 


is audience template attempts to maintain a 6 quality level compared to 
Th d template attempts t t 70% quality level pared t 


the input video. You may notice a small number of imperfections added by the 


encoding process. 


70% Quality Download (VBR) Audience 


Setting or Property 


Player compatibility 


Value 


RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 


Quality target 70% 
Maximum bandwidth 1400 Kbps 
Target video frame rate 30 fps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 
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70% Quality Download (VBR) Audience (continued) 


Setting or Property Value 


Voice codec for audio-only 96 Kbps Stereo Music - RealAudio 
Music codec for audio-only 320 Kbps Stereo Music - RealAudio 10 
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80% Quality Download (VBR) 


This audience improves on the 70% Quality Download (VBR) audience 
settings. 


80% Quality Download (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 

Quality target 80% 

Maximum bandwidth 2000 Kbps 

Target video frame rate 30 fps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


320 Kbps Stereo Music - RealAudio 10 
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90% Quality Download (VBR) 


This audience attempts to replicate the input video nearly perfectly, within the 
constraints set by the maximum bandwidth and the video dimensions. 


90% Quality Download (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 
RealPlayer G2 and later for audio-only voice 

Quality target 90% 

Maximum bandwidth 4000 Kbps 

Target video frame rate 30 fps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


320 Kbps Stereo Music - RealAudio 10 


100% Quality Download (VBR) 


Choose this audience to replicate the input video as perfectly as possible, given 
the constraints set by the maximum bandwidth and the video dimensions. 


100% Quality Download (VBR) Audience 


Setting or Property Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only music, 


RealPlayer G2 and later for audio-only voice 


Quality target 100% 


Maximum bandwidth 10,000 Kbps 
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100% Quality Download (VBR) Audience (continued) 


Setting or Property 


Target video frame rate 


Value 


30 fps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


mono or stereo voice or music 


Audio output 


mono or stereo voice, stereo music 


Voice codec for video 


64 Kbps voice 


Music codec for video 


96 Kbps Stereo Music - RealAudio 


Voice codec for audio-only 


96 Kbps Stereo Music - RealAudio 


Music codec for audio-only 


Stereo Surround Audiences 


320 Kbps Stereo Music - RealAudio 10 
(Table Page 2 of 2) 


The stereo surround audiences are similar to the VBR audiences described in 


“Variable Bit Rate Download Audiences” on page 120. You can use them for 


downloadable or streaming clips. However, you should select one of the 


following stereo surround audiences only if your audio input is stereo 


surround: 


- 350k Surround Stereo 
¢ 450k Surround Stereo 


VBR) 
VBR) 


- 750k Surround Stereo (VBR) 


+ 1M Surround Stereo (VBR) 
+ 2M Surround Stereo (VBR) 


For More Information: For background, refer to “What is Stereo 


Surround?” on page 41. If you plan to stream a clip encoded 


with one of these audiences, see “VBR Clips for Streaming and 


Broadcasting” on page 65. 
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350k Surround Stereo (VBR) 


This is the lowest-speed audience offering stereo surround encoding. 


350k Surround Stereo (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only clips 

Average bandwidth 350 Kbps 

Maximum bandwidth 700 Kbps 

Target video frame rate 30 fps 

Average video bandwidth 306 Kbps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


stereo surround voice or music 


Audio output 


stereo surround voice or music 


Voice codec for video 


44 Kbps Stereo Surround Audio - RealAudio 


Music codec for video 


44 Kbps Stereo Surround Audio - RealAudio 


Voice codec for audio-only 


192 Kbps Stereo Surround - RealAudio 10 


Music codec for audio-only 


320 Kbps Stereo Surround - RealAudio 10 


450k Surround Stereo (VBR) 


This audience offers the same audio quality as the 350k Surround Stereo 
(VBR) audience. 


450k Surround Stereo (VBR) Audience 


Setting or Property 


Player compatibility 


Value 


RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only clips 


Average bandwidth 450 Kbps 
Maximum bandwidth 900 Kbps 
Target video frame rate 30 fps 

Average video bandwidth 406 Kbps 
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450k Surround Stereo (VBR) Audience (continued) 


Setting or Property 


Recommended video sizes 


Value 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


stereo surround voice or music 


Audio output 


stereo surround voice or music 


Voice codec for video 


44 Kbps Stereo Surround Audio - RealAudio 


Music codec for video 


44 Kbps Stereo Surround Audio - RealAudio 


Voice codec for audio-only 


192 Kbps Stereo Surround - RealAudio 10 


Music codec for audio-only 


320 Kbps Stereo Surround - RealAudio 10 
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750k Surround Stereo (VBR) 


For audio-only clips, this audience provides the same sound quality as the 
350k Surround Stereo (VBR) and 450k Surround Stereo (VBR) audiences. The 
audio quality for video clips is higher, however. 


750k Surround Stereo (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later with RealVideo 9 or 10, 
RealPlayer 8 and later with RealVideo 8, 
RealOne Player and later for audio-only clips 

Average bandwidth 700 Kbps 

Maximum bandwidth 1400 Kbps 

Target video frame rate 30 fps 


Average video bandwidth 


604 or 636 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


stereo surround voice or music 


Audio output 


stereo surround voice or music 


Voice codec for video 


64 Kbps Stereo Surround Audio - RealAudio 


Music codec for video 


96 Kbps Stereo Surround Audio - RealAudio 
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750k Surround Stereo (VBR) Audience (continued) 


Setting or Property Value 


Voice codec for audio-only 192 Kbps Stereo Surround - RealAudio 10 
Music codec for audio-only 320 Kbps Stereo Surround - RealAudio 10 


(Table Page 2 of 2) 


1M Surround Stereo (VBR) 


This audience offers high fidelity downloads, with improved audio quality 
over the 750k Surround Stereo (VBR) audience. 
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1M Surround Stereo (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later 
Average bandwidth 1 Mbps 

Maximum bandwidth 2 Mbps 

Target video frame rate 30 fps 


Average video bandwidth 


872 or 936 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


stereo surround voice or music 


Audio output 


stereo surround voice or music 


Voice codec for video 


64 Kbps Stereo Surround Audio - RealAudio 


Music codec for video 


128 Kbps Stereo Surround - RealAudio 10 


Voice codec for audio-only 


256 Kbps Stereo Surround - RealAudio 10 


Music codec for audio-only 


320 Kbps Stereo Surround - RealAudio 10 


2M Surround Stereo (VBR) 
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This audience offers very high fidelity downloads, with improved audio 


quality over the 1M Surround Stereo (VBR) audience. 


2M Surround Stereo (VBR) Audience 


Setting or Property 


Player compatibility 


Value 


RealOne Player and later 


Average bandwidth 2 Mbps 
Maximum bandwidth 4 Mbps 
Target video frame rate 30 fps 


Average video bandwidth 


1840 or 1903 Kbps depending on audio choice 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


stereo surround voice or music 


Audio output 


stereo surround voice or music 


Voice codec for video 


96 Kbps Stereo Surround Audio - RealAudio 


Music codec for video 


160 Kbps Stereo Surround - RealAudio 10 


Voice codec for audio-only 


320 Kbps Stereo Surround - RealAudio 10 


Music codec for audio-only 


Multichannel Audio Audiences 


320 Kbps Stereo Surround - RealAudio 10 


The multichannel audiences are similar to the VBR audiences described in 


“Variable Bit Rate Download Audiences” on page 120. You can use them for 


downloadable or streaming clips. However, you should select one of the 


following multichannel audiences only if your audio input has discrete, 


multichannel audio that you wish to preserve: 
+ 350k Multichannel (VBR) 
« 450k Multichannel (VBR) 


+ 750k Multichannel (VBR) 
+ 1M Multichannel (VBR) 
+ 2M Multichannel (VBR) 
« SM Multichannel (VBR) 
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For More Information: For background, refer to “What is 


Multichannel Audio?” on page 44. If you plan to stream a clip 


encoded with a multichannel audience, refer to “VBR Clips for 


Streaming and Broadcasting” on page 65. 


350k Multichannel (VBR) 


This is the lowest-speed audience that preserves multichannel audio data. 


350k Multichannel (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later 
Average bandwidth 350 Kbps 

Maximum bandwidth 700 Kbps 

Target video frame rate 30 fps 

Average video bandwidth 254 Kbps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


discrete multichannel voice or audio 


Audio output 


discrete multichannel voice or audio 


Voice codec for video 


96 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for video 


96 Kbps 5.1 Multichannel - RealAudio 10 


Voice codec for audio-only 


184 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for audio-only 


450k Multichannel (VBR) 


268 Kbps 5.1 Multichannel - RealAudio 10 


The audio encoding rates for this audience are the same as the 350k 


Multichannel (VBR) audience. Its higher bandwidth improves video quality 


only. 


450k Multichannel (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later 


Average bandwidth 


450 Kbps 
(Table Page 1 of 2) 
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450k Multichannel (VBR) Audience (continued) 


Setting or Property Value 
Maximum bandwidth 900 Kbps 
Target video frame rate 30 fps 
Average video bandwidth 354 Kbps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


discrete multichannel voice or audio 


Audio output 


discrete multichannel voice or audio 


Voice codec for video 


96 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for video 


96 Kbps 5.1 Multichannel - RealAudio 10 


Voice codec for audio-only 


184 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for audio-only 


750k Multichannel (VBR) 


268 Kbps 5.1 Multichannel - RealAudio 10 
(Table Page 2 of 2) 


This audience offers improved audio and video quality over the 450k 
Multichannel (VBR) audience. 


750k Multichannel (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later 
Average bandwidth 700 Kbps 

Maximum bandwidth 1400 Kbps 

Target video frame rate 30 fps 

Average video bandwidth 569 Kbps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


discrete multichannel voice or audio 


Audio output 


discrete multichannel voice or audio 


Voice codec for video 


132 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for video 


132 Kbps 5.1 Multichannel - RealAudio 10 
(Table Page 1 of 2) 
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750k Multichannel (VBR) Audience (continued) 


Setting or Property Value 


Voice codec for audio-only 268 Kbps 5.1 Multichannel - RealAudio 10 
Music codec for audio-only 268 Kbps 5.1 Multichannel - RealAudio 10 


(Table Page 2 of 2) 


1M Multichannel (VBR) 


The audience offers improved video quality over the 750k Multichannel (VBR) 
audience. For audio-only clips, however, the audio quality is the same. 


1M Multichannel (VBR) Audience 


Setting or Property Value 

Player compatibility RealOne Player and later 

Average bandwidth 1 Mbps 

Maximum bandwidth 2 Mbps 

Target video frame rate 30 fps 

Average video bandwidth 817 Kbps 

Recommended video sizes 320-by-240 or larger 

RealVideo codec RealVideo 10 

SureStream compatible no 

Audio input discrete multichannel voice or audio 
Audio output discrete multichannel voice or audio 

Voice codec for video 184 Kbps 5.1 Multichannel - RealAudio 10 
Music codec for video 184 Kbps 5.1 Multichannel - RealAudio 10 
Voice codec for audio-only 268 Kbps 5.1 Multichannel - RealAudio 10 
Music codec for audio-only 268 Kbps 5.1 Multichannel - RealAudio 10 
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This audience provides the highest overall audio quality of the multichannel 


audiences. 


2M Multichannel (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later 
Average bandwidth 2 Mbps 

Maximum bandwidth 4 Mbps 

Target video frame rate 30 fps 

Average video bandwidth 1732 Kbps 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


discrete multichannel voice or audio 


Audio output 


discrete multichannel voice or audio 


Voice codec for video 


268 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for video 


268 Kbps 5.1 Multichannel - RealAudio 10 


Voice codec for audio-only 


268 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for audio-only 


268 Kbps 5.1 Multichannel - RealAudio 10 


5M Multichannel (VBR) 


This audience offers very high fidelity downloads. The audio encoding quality 


is the same as the 2M Multichannel (VBR) audience. You will notice 


improvements in the visual quality only. 


5M Multichannel (VBR) Audience 


Setting or Property 


Value 


Player compatibility RealOne Player and later 
Average bandwidth 5 Mbps 

Maximum bandwidth 10 Mbps 

Target video frame rate 30 fps 

Average video bandwidth 4732 Kbps 


Recommended video sizes 


320-by-240 or larger 
(Table Page 1 of 2) 
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5M Multichannel (VBR) Audience (continued) 


Setting or Property 


Value 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


discrete multichannel voice or audio 


Audio output 


discrete multichannel voice or audio 


Voice codec for video 


268 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for video 


268 Kbps 5.1 Multichannel - RealAudio 10 


Voice codec for audio-only 


268 Kbps 5.1 Multichannel - RealAudio 10 


Music codec for audio-only 


Lossless Audio 
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268 Kbps 5.1 Multichannel - RealAudio 10 
(Table Page 2 of 2) 


The lossless audio audience is intended primarily to encode audio-only clips 


in a lossless format, which the section “Lossless Audio Codec” on page 45 


describes. You can use it to encode lossless audio with a video clip as well. 


However, the amount of bandwidth given to the video’s visual track can var 
5 g y 


greatly depending on how much bandwidth is required to encode the audio 


losslessly. 


Setting or Property 


Lossless Audio Audience 


Value 


Player compatibility RealOne Player and later 
Average bandwidth 2 Mbps 

Maximum bandwidth 4 Mbps 

Target video frame rate 30 fps 

Average video bandwidth n/a 


Recommended video sizes 


320-by-240 or larger 


RealVideo codec 


RealVideo 10 


SureStream compatible 


no 


Audio input 


high-fidelity mono or stereo voice or audio 


Audio output 


high-fidelity mono or stereo voice or audio 


Voice codec for video 


RealAudio Lossless Audio 


Music codec for video 


RealAudio Lossless Audio 
(Table Page 1 of 2) 
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Lossless Audio Audience (continued) 


Setting or Property Value 


Voice codec for audio-only RealAudio Lossless Audio 
Music codec for audio-only RealAudio Lossless Audio 


(Table Page 2 of 2) 


Note: Encoding with the lossless audio codec is supported only 
through the command-line application, which Chapter 14 
covers. This audience is not available through the graphical 
application. 


For More Information: The encoding complexity mode affects 
both the lossless audio codec and the video codec. For 
background, refer to “Encoding Complexity Modes” on page 
79. 
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CHAPTER 


8 


MONITORING A JOB 


This chapter shows you how to start an encoding job, and describes 
the different methods for monitoring a job. You will learn about 
encoding statistics, as well as the logging tool that displays errors 


and warnings about a job as it runs. 


Starting an Encoding Job 


Once you have set up an encoding job, you can start and monitor the 
encoding process. The following procedure explains how to start and stop an 
encoding job. 


> To start encoding a job: 


1. If you are encoding from a live source, make sure that the capture 
equipment is functioning properly and is connected to the computer’s 
capture card. 


2. If you have multiple jobs open, select the job you want to encode in the 
job manager list. 


3. Ensure that you have set the correct encoding parameters, such as clip 
information, Music or Voice audio choice, and audiences, as described in 
Chapter 6. 


4. Click the Encode button. During encoding, you can use any of the 
monitoring tools described in this chapter. 


Stopping an Encoding Job 


When you are finished encoding, click the Stop button. Or, if you have set a 
duration for the encode, you can wait until the duration is complete. Note 
that if you have defined multiple destinations, clicking Stop halts the 
encoding process for all destinations. You cannot stop the encoding process 


141 


RealProducer 10 User’s Guide 


for one destination (such as writing to a clip) while continuing the process for 
another destination (such as broadcast to a server). 


Playing a Media Clip 


After the encoding process has finished, you can play a destination clip as long 
as you have RealPlayer installed on the RealProducer machine. To do this, 
choose File>Play RealMedia File (Ctrl+p), or click the RealPlayer play button 
below the destination window. Do not use this feature when encoding a live 
broadcast, however. 


Monitoring Audio 
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As you encode clips, you can monitor the audio levels for both the input audio 
and the encoded output audio. This helps to ensure that the audio levels are 
encoded in the optimal dynamic range. On an input or output audio meter, 
green for the left or right channel indicates a normal reading. Red warns that 
the audio is close to being over-modulated. If the audio registers above the 
possible dynamic range, the clipping indicator above the meter lights up to 
indicate that the audio has become distorted. 


Audio Meter 


a 
Pies 
“437 


~4987 


= 397 


—--  — 


M dB M 


Disabling the Audio Meters 


Optionally, you can disable the audio monitors. This helps to speed the 
encoding process, and is useful in live broadcasts in which you want to 
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conserve as much processing power as possible. To turn off a meter, select 
View>Input Audio Meter, View>Output Audio Meter, or both. Selecting these 
options again reinstates the audio meters. 


Adjusting Audio Gain 


With RealProducer Plus, you can adjust the audio output using the Gain 
palette, which you can display with the Settings>Show Audio Gain Control 
(Ctrl+r) command. In this palette, you set a decibel gain from +12 (amplify the 
audio) to -12 (attenuate the audio). RealProducer saves the gain setting when 
you close the palette. The gain settings apply only to the current job. 


Audio Gain Palette 


0 dB 


a 


N 


When you amplify the audio signal, RealProducer dynamically compresses the 
audio range if the output signal becomes overmodulated. Thus, the output 
audio is never clipped, even at the maximum gain level. A value of 6 doubles 
the audio level while a value of 12 quadruples it. A value of -6 reduces the level 
to half, while -12 reduces it to a quarter. 


For More Information: Using a job file, you can specify a wider 
range. See “Audio Gain Prefilter” on page 316. 


Preventing Clipped Audio Input 


When the input audio has an audio gain that causes distortion, the clipping 
indicators above the input audio meter light up. In this case, RealProducer’s 
gain control cannot eliminate the distortion. To eliminate the distortion, you 
may need to adjust the settings in your audio hardware or software that 
provides the audio input to RealProducer. 
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For example, the sound capture card may have its mixer levels set too high. In 
this case, adjust the analog gains leading to your sound card input so that the 
input audio meter on RealProducer never rises to the 0 dB level. If needed, 
modify audio gain through an external mixer board if the sound card's audio 
mixer does not provide adequate control. 


With certain material and input sources, however, the external mixing may 
lead to sound levels that are too low on average. In this case, you can use the 
RealProducer gain control tool to bring the signal back up to acceptable levels. 
This is safe to do because the gain tool will not introduce clipping. 


Monitoring Video Output 


When your encoding job contains video, you will see the source video play in 
the input preview window. The output displays in the output preview window. 
Optionally, you can disable the input or output video windows. This helps to 
speed the encoding process by eliminating the need for RealProducer to 
display the video onscreen. This is useful in live broadcasts in which you want 
to conserve as much processing power as possible. To turn off a window, select 
View> Input Video, View>Output Video, or both. Selecting these options again 
reinstates the video display. 


Monitoring Statistics 
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RealProducer displays a number of encoding statistics that you can monitor 
as you encode a clip or broadcast. These statistics provide an overview of the 
encoded output, showing you how well the encoding process meets your 
target settings. You can open the statistics window at any point before or 
during encoding by selecting View>Show Statistics (Ctrl+y). The job title 
appears at the top of the window. 


Statistics Window 


Encoding Statistics - NarrowbandEncoding x| 


16k Substream for 14 kbps 7.50 Le? 
28k Dial-up 18 kbps 10 kbps 8 kbps 8.83 3.33 13 d as 
56k Dial-up 31 kbps 23 kbps 8 kbps 15.01 6.67 
256k DSL or Cable 240 kbps 196 kbps 44 kbps 15.01 15.00 


Total output bitrate: 303 kbps Audience Properties Save To File 
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Encoding Statistics Phases 


RealProducer displays three different sets of statistics during three phases of 
the encoding process. 


Job Configured but not Running 


If you have configured an encoding job but not yet started it, the statistics 
window shows how the streams are configured. For a variable bit rate 
encoding (VBR), you'll see one audience. For a constant bit rate encoding 
(CBR), you'll see a separate line for each audience you’ve added. The statistics 
show the total bit rate for each stream, as well as the bit rates for the video and 
audio. They also show the maximum frames per second (FPS) for the video. 


Job Running 


As you run an encoding job, the statistics window updates in real time to show 
how each stream is being encoded. Statistics do not display during the first 
pass of two-pass encoding, however. 


Job Finished 


When the encoding completes, the statistics window shows you the actual 
statistics for the entire encoding job. Some statistics, such as frames per 
second (FPS), are listed as averages. 


Encoding Statistics Values 


The following table summarizes the encoding statistics that RealProducer 
displays. During the encoding, some statistics update in real-time. After the 
encoding, some fields display average values. 


Statistics Summary 


Statistic Description 
Audience Lists the audience template used to encode the stream. 
Total Bit Rate Indicates the total bit rate of the encoded audience stream, in the 


form of Kilobits per second (Kbps) with single decimal precision. 
If the rate is over 1 Megabit per second, the value is in Mbps with 
two decimal precision. 


Video Bit Rate Gives the bit rate of the video portion of the stream. If there is no 
video in the output, this displays as n/a. 


(Table Page 1 of 2) 
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Statistics Summary (continued) 


Statistic Description 


Audio Bit Rate Lists the bit rate of the audio portion of the stream. If there is no 
audio in the output, this displays as n/a. 


FPS Lists the video’s frames per second. If encoding has not started, 
the value is the maximum target. During an encoding. the value is 
the actual fps being encoded. After the encoding, this field gives 
the average frame rate. For an audio-only clip, the value is n/a. 


Min. FPS Gives the minimum frame rate, in frames per second, encoded 
into the stream. For an audio-only clip, or before video encoding 
has started, the value is n/a. 


Quality Lists the quality level of the output compared to the input after all 
video filters have been applied. A value of 100 percent represents 
equivalent quality to the input. For an audio-only clip, or before 
video encoding has started, the value is n/a. See “Video Quality 
Index” on page 146. 


Min. Quality Indicates the minimum quality level of the clip during encoding. 
For an audio-only clip, or before video encoding has started, the 
value is n/a. 


Pre-roll Lists the number of seconds of preroll (buffering) that the viewer 
will experience when beginning to play the encoded stream. 
(Table Page 2 of 2) 


Video Quality Index 
The quality index indicates how well each RealVideo stream will play back: 


- A value of 94 to 100 means that the clip will play back with excellent 
quality. You could even increase the video frame rate or window size and 
achieve high quality. 

- Avalue of 60 to 93 represents the efficiency range of the RealVideo codec. 
Streams with these values will have good visual clarity and a high frame 
rate. 


- A value of 40 to 59 indicates fair quality. These stream may have some 
visual artifacts and slow frame rates in some if not all sections. You’ll 
achieve higher quality by shrinking the source video’s window size. 


- A value from 0 to 40 indicates poor quality playback with a slow frame 
rate and a high number of artifacts. You should shrink the video’s window 
size if you intend to stream at this speed. 
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Tip: The purpose of SureStream substreams is to keep the 
presentation running during adverse network conditions. A 
poor quality level is therefore acceptable for these streams. 


Viewing Log Messages 
RealProducer records messages about encoding tasks as they occur. Whereas 
the monitoring window provides statistics about the encoding job, the log file 
informs you about RealProducer performance, such as its CPU use. After a job 
has run, you can view the log files to find encoding errors or diagnostic 
messages. You can also use the log viewer to display encoding information on 
the screen in real-time, or after the job has finished. 


For More Information: The RealProducer preferences set the log 
file location and features, and determine how many messages 
display in the log viewer. See “Changing Log File and Log 
Viewer Preferences” on page 151 for more information. 


Using the Log Viewer 


The log viewer gives you a real-time view of the log messages as RealProducer 
generates them. It also provides the ability to filter the log to display just one 
type of message. Displaying the log viewer during encoding is particularly 
useful when you encode a live broadcast because the viewer can warn you 
about problems such as excess CPU consumption and lowered frame rates. 


> To open the log viewer: 


1. Select View>Show Log Viewer (Ctrl+L) to display the log viewer. The most 
recent messages display at the top of the window. 


2. You can filter the types of information (errors, warnings, information, 
and diagnostic) that the log viewer lists by selecting the appropriate check 
boxes. The log viewer preferences determine which message types are 
actually recorded to the log. 


Tip: You can select and deselect the message types during 
encoding to update the log viewer output in real-time. 


3. You can also display messages according to the functional area, such as 
only the messages related to audio codecs. The default value of Show all 
displays all functional area messages. 


147 


RealProducer 10 User’s Guide 


4. After a job runs, you can save the messages to a separate text file by 
clicking the Save Messages button and choosing a file name and location. 


5. Click Clear Messages if you want to reset the log viewer before or after 
running a job. 
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MODIFYING DEFAULT SETTINGS 


In this chapter, you learn how to modify the RealProducer 
preferences, which determine where RealProducer stores files, and 
how it logs error and informational messages. This chapter also 
explains how to change the default audience settings, or create new 


audiences, to customize how RealProducer encodes streams. 


Adjusting RealProducer Preferences 


You can adjust the RealProducer preferences to determine how and where 
RealProducer stores support files. These preferences affect all jobs. 


For More Information: You can modify the RealProducer 
preferences manually as described in Appendix E. 


Changing the File Location Preferences 


You can change the default setting for where RealProducer creates the output 
files, as well as where it stores temporary files and its audience and server 
templates. 
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File Location Preferences 


Category: Default Directory for File Destination 
|v Automatically create a file for each job 
(@ Same location as source file 


C Other: l. Browse.. 


User Directories 
| Audience Templates: 
CAProgram Files\Real\RealProducer Plus 10\aud Browse... | 


| Server Templates: 


C:\Program Files\Real\RealProducer Plus 10\ser Browse... | 


> Temporary Storage Directory 
© Same location as file destination 


| @ Other [C\DOCUME™T\Jay\LOCALS™1\Temp\ | Browse... 


OK | Cancel | Help | 


» To change the default file locations: 
1. Select Edit>Preferences to open the preferences dialog. 
2. Choose the File Locations category. 


3. The default selection of Automatically create a file for each job causes 
RealProducer to define an output clip that uses the same base file name as 
the input clip you select. When you use this feature, you can automatically 
save the output in one of the following locations: 


+ Same Location as Source File—Save the encoded output clip in the same 
directory as the input media file. 


+ Other—Save all encoded clips in the directory you specify. Either enter 
the full path to the directory, or click Browse and navigate to the 
directory you want to use. 


Note: If you choose not to define an output clip automatically, 
you must always set up the output clip destination. When you 
use this automatic output feature, you can always change the 
name or location of the clip destination manually. For 
instructions, refer to “Modifying a Clip Destination” on page 
91. 


4. Under User Directories, you can choose where RealProducer stores its 
audience and server templates: 
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+ In the Audience Template field, enter the full path name of the 
directory that stores audience files. Or, click the Browse button and 
navigate to the directory you want to use. Appendix C explains 


audience files. 


+ In the Server Template field, enter the full path name of the directory 
that stores server files. Or, click the Browse button and navigate to the 
directory you want to use. Appendix D explains server files. 


Note: If you change the storage location of audience or server 
files, manually move any existing files that you want to 
continue using to the new location. 


5. RealProducer uses a temporary directory to save data that it uses during 
encoding. To change this preference, select one of the following options in 
the Temporary Storage Directory section: 


+ Same Location as File Destination—Saves the temporary data in the 
same directory as the destination clip. 


+ Other—Saves temporary data in the directory you specify. Either enter 
the full path to the directory, or click Browse and navigate to the 


directory you want to use. 


Note: If you use %TEMP% in this field, RealProducer uses the 
same directory specified by the Windows TEMP variable. After 
you close and restart RealProducer, this field lists the full path 
to the %TEMP% directory. 


Tip: RealProducer operates faster if the temporary directory 
resides on the local RealProducer machine, rather than a 


network drive. 


6. Click OK to save the preferences. 


Changing Log File and Log Viewer Preferences 


RealProducer automatically logs information about encoding jobs in a text 
file. Through the preferences, you can turn off logging or modify the log file 
settings. You can display and filter log messages on-screen with the log viewer, 
which the section “Viewing Log Messages” on page 147 describes. 
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Log File Preferences 


Category: 


File Locations 


Log Viewer 


|v Enable logging to file 


—Log Location 


C:\Program Files\Real\RealProducer Plus 10\pro Browse... | 


;-Log Contents 


Logformat Messages: Functional Areas: 
@ Detailed © [¥ Errors @ Show all 
© Short 1\ [¥ Wamings © Show selected 
.2|¥ Information [ Activex Pe 


[~ Audio Codec 


> [ Diagnostic 
| Audio Pre-filters 


| | 


—Log File Rolling 


[~ Enable log file rolling 


© Pallfile ever [o MB. 


@ Poll log atthe beginning of every: 


OK Cancel | Help 


> To modify log file settings: 


1. 
2. 


Select Edit>Preferences to open the preferences dialog. 
Choose the Log File category. 


. To disable logging, uncheck the Enable logging to file box. You can set the 


remaining preferences only if logging is enabled. 


. In the Log Location field, enter the full path name of the directory that 
stores the log file. Or, click the Browse button and navigate to the 
directory you want to use. Along with the path, choose a name for the log 
file, using .log as the file extension. The default location is the main 


RealProducer installation directory. 


+ For the log format, you can choose Short to log only the job name and 
message. 


+ Under Messages, you can choose any combination of the following 


message 


message 


Errors 


Warnings 


. For Log Contents, you can specify the events that you want to log: 


The Detailed format logs more information, such as the 
category, functional area, time, and message number. 


types: 


Error messages are severe problems that typically cause the 


encoding operation to fail. 


Warning messages indicate possible problems that did not 


cause the encoding to fail. 
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Information Informational messages convey important messages about 
the encoding operation. 


Diagnostic Diagnostic messages convey non-critical messages about the 
encoding operation. An encoding operation may generate 
many diagnostic messages, so including this message type 
may cause your log file to grow quickly. 


+ Under Functional Areas, the default is Show all, meaning that 
RealProducer logs messages from all areas of operation. If you want to 
log messages for just some areas, such as broadcasting or video codec 
operations, click Show selected and choose the appropriate functional 
areas. 


6. By default, RealProducer logs all messages to the specified file, allowing 
the file to grow indefinitely. If you encode clips or broadcasts frequently, 
or you include diagnostic messages in the log, you should check Enable log 
file rolling. Then, choose a maximum log file size in Megabytes, or a time 
limit: 
month Create a new log file at midnight of the last day of each month. 
week Set up a new log file at midnight of Sunday of each week. 
day Write a new log file at midnight of each day. 
hour Roll the log file at the top of each hour. 


RealProducer creates a new log file under a new name when the current 
log file reaches the size or time limit. The file extension includes a 
numeric designation to indicate the order of the log files. For example, if 
your log file is named producer.log, the first rolled file is named 
producer.log1, the second is producer.log2, and so on. 


7. Click Log Viewer to change the number of messages from the log file that 
the log viewer displays. The default is 1000. The section “Viewing Log 
Messages” on page 147 explains how to use this viewer. 


8. Click OK to save the preferences. 


Creating and Editing Audiences 


You can fine-tune the audience templates installed with RealProducer. This 
section explains how to change audience settings for a single job, or all jobs. It 
also provides instructions and tips for creating your own audience templates. 
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Changing Audience Values for the Active Job 


Using RealProducer Plus, you can change the audience properties for an active 
job. First, add the audience to your job as described in “Choosing Audiences” 
on page 98. Then, click the audience name in the Audiences palette to display 
the Audience Properties dialog. You can then change the audience settings as 
described in the following sections. Optionally, you can click Save as Template 
to save the audience modifications permanently. 


Change Audience Properties for a Job 


33 Audience Properties - 256k DSL or Cable x 
Audience name: 256k DSL or Cable 
, Audio/Video Encoding 
Constant bit rate: 222 + kbps 


Variable bitrate Meximurn bit rete 


© Target average bitrate 
© Tergetvides quality 70 | Y 
Target frame rate: 30.00 | FPS 
Advanced Video Options... 
Voice codec: 32 Kbps - RealAudio Me | 


Musiccodec: 44 Kbps Stereo Music High Response - RealAudio in | 


Average video bit rate: With voice, 190 kbps 
With music, 177.9 kbps 


Audio Only Encoding 
| Voicecodec: fo4 Kbps - RealAudio =| 
Musiccodec: 256 Kbps Stereo Music- RealAudio 10 =| 


Save as Template | 


Editing, Creating, or Deleting an Audience Template 


When you use RealProducer Plus, you can edit any audience template to 
change it permanently. You can also create a new template from an existing 
one to define your own audiences. (With RealProducer Basic, you can create 
one new template.) These changes are recorded in the template and the active 
job, but not in any previous jobs that also used the audience template. To 
update an older job, edit the job file manually. Or, open the job in the 
graphical application, delete the existing audience or audiences, then add the 
new audiences. 
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For More Information: The section “Choosing Audiences” on 
page 98 explains how to add and remove audiences from a job 
using the graphical application. See “Audiences Section” on 
page 329 for details about how a job file stores audience 


information. 


Edit Audience Templates 


#, Audience Templates 


26k Substream for 56k Dial-up 26 kbps 
56k Dial-up > 34 kbps 
64k Single ISDN 50 kbps 
General Mobile Local Playback 80 kbps 
128k Dual ISDN 100 kbps 


150k LAN 150 kbps 
PocketPC Local Playback 200 kbps 
256k DSL or Cable 225 kbps 
350k Download (VBR) 350 kbps 


350k Multichannel (VBR) 350 kbps 
350k Surround Stereo (VBR) 350 kbps 
384k DSL or Cable 350 kbps 
450k Download (VBR) 450 kbps 
450k Multichannel (VBR) 450 kbps 
450k Surround Stereo (VBR) 450 kbps 
512k DSL or Cable 450 kbps 
70% Quality Download (VBR) 700 kbps 


S| a 


Restore Selected Template 


Restore All Default Templates | 


12k Substream for 28k Dial-up 12 kbps 
16k Substream for 28k Dial-up 16 kbps 
General Mobile Streaming 20 kbps 
28k Dial-up 20 kbps 


x| 
Template name: 56k Dial-up 
, Audio/Video Encoding 
@ Constant bit rate: 34 4 kbps 
C Variable bit rate: Maximum bit rate fae | kiaps 
© Targ age hit rate [a4 r| kbps 
© Jargetvideo quality 30 = % 
Target frame rate: 15.00 | FPS 
Advanced Video Options... 
Voice codec: 6.5 Kbps - RealAudio | 
Musiccodec: |8 Kbps Music- RealAudio | 
Average video bit rate: With voice. 27.6 kbps 
‘With music, 26 kbps 
;-Audio Only Encoding 
Voice codec: 32 Kbps - RealAudio =| 
Musiccodec: 132 Kbps Stereo Music High Response - RealAudio =| 


OK | Cencel_ | 


Apply. 


Help 


> To edit or create an audience template: 


1. Select Edit>Audience Templates to list all available templates. 


2. Select a template from the list. This displays the template’s settings in the 
right-hand side of the dialog. 


Tip: Within the list, templates are ordered according to the 
audience’s average streaming speed or quality setting. 


3. You can then perform any of the following actions: 


a. Edit the settings for the template as described in the following 


sections. 


b. Click the “duplicate” icon at the bottom of the template list to copy 
the selected template. Then, edit the settings fields. This allows you to 
create a similar template quickly. 
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c. Click the trash icon to delete the selected template. 


4. Click Apply to save changes to the template. Click OK to exit the dialog 
and save any changes. 


Tip: If you have altered and saved an original, default template, 
you can restore the default values to the template by selecting 
the template clicking Restore Selected Template. Click Restore 
All Templates to reset default values to all predefined templates. 
These buttons have no effect on templates you have created. 


Choosing a Template Name 


When you edit a template or create a new one, you specify a name in the 
Template name field. The graphical application uses this name to identify the 
template. You can also use this name to specify the audience with the 
command-line application, as described in “Audience Definitions or Audience 
Files (-ad)” on page 269. RealProducer uses the template name as the file name 
for the audience file, appending the .rpad extension automatically. 


Setting CBR or VBR Encoding 


In an audience template, you can specify that the audience uses constant bit 
rate (CBR) or variable bit rate (VBR) encoding. For background on these 
choices, refer to “Constant Bit Rate Video” on page 61 and “Variable Bit Rate 
Video” on page 64. With the exception of the RealAudio Lossless codec, which 
you cannot select in the graphical application, you can use any RealAudio 
codec in a CBR or VBR template. 


CBR Maximum Bandwidth 


For a CBR audience, you specify the total, maximum streaming speed. This 
should be less than the raw bandwidth of the connection type. For example, 
you should not set an audience template for 56 Kbps modems to stream at 56 
Kbps. These modems do not actually provide that much usable bandwidth. 
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The following table lists maximum streaming rates for common Internet 


connections. 
Maximum Streaming Rates 

Target Audience Maximum Streaming Rate 
14.4 Kbps modem 10 Kbps 

28.8 Kbps modem 20 Kbps 

56 Kbps modem 34 Kbps 

64 Kbps ISDN 45 Kbps 

112 Kbps dual ISDN 80 Kbps 

Corporate LAN 150 Kbps 


256 Kbps DSL/cable modem | 225 Kbps 
384 Kbps DSL/cable modem | 350 Kbps 
512 Kbps DSL/cable modem | 450 Kbps 
786 Kbps DSL/cable modem | 700 Kbps 


For any other connection speed, calculate the maximum streaming speed as: 


- Approximately 75 percent of the connection bandwidth for analog 
connections such as dial-up modems. 

- Approximately 90 percent of the connection bandwidth for high-speed 
digital connections such as DSL or cable modems. 


VBR Settings 


For a variable bit rate audience, you set a maximum bit rate along with an 
average bit rate or a quality target. The maximum bit rate should be 50 to 100 
percent higher than an average bit rate. A VBR clip with an average bit rate of 
300 Kbps should have a maximum bit rate of 450 to 600 Kbps, for example. 


For More Information: The section “VBR Encoding Settings” on 
page 66 explains the relationship between maximum bit rate, 
average bit rate, and quality. 


Video Settings 


The Target frame rate field sets the ideal maximum video frame rate for the 
audience, measured in frames per second (fps). A higher frame rate creates 
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smoother motion. Cinematic film uses 24 fps, for example, while NTSC video 
uses 30 fps. The section “Encoded Frame Rates” on page 57 explains frame 
rates and their relationship to visual clarity. 


For bandwidths under 150 Kbps, RealNetworks recommends a maximum 
frame rate of 15 fps. This provides acceptably smooth motion without 
sacrificing too much visual clarity. At higher bit rates, you can select up to 30 
fps. For mobile devices that have slower processors than desktop machines, 
you may want to choose a slower maximum rate, such as 5 to 7.5 fps. 


Note: The frame rate setting specifies an ideal maximum only. 
Other factors, such as available bandwidth and video size affect 
the final frame rate. The monitoring utility, described in 
“Monitoring Statistics” on page 144, shows actual frame rate 
encoded into a stream. 


Advanced Video Stream Options 


Click Advanced Video Options to change specific parameters about how 
RealProducer encodes video clips. In general, the default values work well for 
most audiences, and you should not change these settings unless you have 
specific reasons to do so and understand the possible, negative effects of your 
choices. For information about these options, refer to the following sections: 


- “Encoding Complexity Modes” on page 79 
- “Video Startup Latency” on page 80 
- “Maximum Time Between Keyframes” on page 80 


- “Loss Protection” on page 82 


Adjusting Audio Stream Settings 


For audio encoding, you select four RealAudio codecs from the pull-down 
lists. For each clip that includes audio, RealProducer selects one of these 
codecs depending on the clip type, such as whether it is audio-only or video, 
and whether the audio track is voice or music. The section “Audio Encoding 
for Audiences” on page 103 explains these choices. For explanations of all 
RealAudio codecs, refer to “RealAudio Codecs” on page 35. Keep the following 
points in mind: 


+ When you set the RealAudio codecs used with a video clip, you must leave 
appropriate bandwidth for the visual track. For tips on balancing audio 
and video bandwidth use, refer to “Soundtrack Bandwidth” on page 55. 
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+ When encoding a clip that uses voice, you typically use one of the voice 
codecs described in “Voice Codecs” on page 37. At higher bandwidths, 
however, you can use a music or stereo music codec to provide greater 


fidelity. 
« Never use a voice codec for music. 


- The audio codec should match the expected audio input. Do not use a 
multichannel codec for traditional stereo input, for example. 


« Your choice of audio codec (as well as video codec) determines which 
versions of RealPlayer can play the clip. The codec descriptions in 
“RealAudio Codecs” on page 35 describe RealPlayer compatibility. 
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PART 


BROADCASTING LIVE EVENTS 


The following chapters cover the basic issues with delivering a 
live broadcast, and explain how to set up a live broadcast on 


both RealProducer and Helix Server. 


CHAPTER 


10 


PLANNING A BROADCAST 


This chapter explains the issues and methods for broadcasting live 
content on a network, whether an intranet or the Internet. It 
introduces you to the types of broadcasts, explains broadcast 
options, and covers advanced broadcast features. When you are 
ready to broadcast, refer to Chapter 11 for instructions about using 


your chosen type of broadcast method. 


Tip: If you are new to streaming media, familiarize yourself 
with the process for encoding static clips, which Chapter 6 
describes. You should also review the audio and video issues 
described in Chapter 4 and Chapter 5. Broadcasting requires 
many of the same choices you make when encoding a clip, and 


introduces new issues of broadcast bandwidth and processor 
load. 


Broadcasting Basics 


In a live broadcast, RealProducer takes live input from a capture card as 
described in “Using Live Audio or Video as the Input” on page 88, encodes it 
as RealAudio or RealVideo, and sends the stream to Helix Server for 
replication and distribution to RealPlayer viewers. You encode a broadcast 
stream using the same audiences you use when creating a static clip, as 
described in Chapter 7. 
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Live Broadcasting 


Live Live 
Stream Stream 
nl ————— >} HoH 
Hy 
RealProducer Helix Server RealPlayer 


Sources 


The Role of Helix Server 


Helix Server is required for a broadcast because RealProducer cannot 
broadcast directly to RealPlayers. Nor you can deliver a broadcast using a Web 
server. The Helix Server license, or practical considerations such as its 
outgoing bandwidth, determine how many RealPlayer viewers you can reach 
with a broadcast. Helix Server must be configured to accept the broadcast, and 
the server setup determines how the broadcast is distributed to RealPlayer 
viewers: 


* unicasting—a separate stream to each RealPlayer 
+ multicasting—a common stream for all RealPlayers 


To send a broadcast stream from RealProducer to Helix Server, you define a 
server destination in RealProducer. The destination records information such 
as the server’s address and the password required for access. By saving a 
destination as a template, you can easily repeat a broadcasts using the same 
parameters. When you run a broadcast, you can send the same stream to 
multiple servers by defining multiple server destinations in your job. You can 
also archive the broadcast as a clip by adding a clip destination to your job. 


Broadcasting Methods 


RealProducer provides several different broadcast methods that you can use. 
Broadcasting methods break down into the two general areas of push and 


pull: 
+ push broadcasting 


In push broadcasting, RealProducer initiates the broadcast stream and 
delivers the stream to Helix Server when the broadcast begins. There are 
several methods of push broadcasting: 
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+ account-based, push broadcast—This is the simplest broadcasting 
method to set up, requiring no configuration on Helix Server. 
RealProducer also receives statistical feedback from Helix Server. See 
“Running an Account-Based Broadcast” on page 179 for more 
information. 


password-only, push broadcast—This is similar to account-based 
broadcasting, but it is more efficient with bandwidth. It requires 
server set-up and does not provide server feedback, however. The 
section “Setting Up a Password-Only Broadcast” on page 184 explains 
this broadcast method. 


multicast push—This method is available if you have a multicast- 
enabled network and you want to deliver the broadcast stream to 
several servers. See “Multicasting a Live Stream” on page 189. 


legacy push broadcast—This method is for broadcasting to servers 
earlier than Helix Server version 9. The section “Setting up a Legacy 
Broadcast” on page 199 provides more information. 


- Pull 


In pull broadcasting, RealProducer does not deliver the broadcast stream 
as soon as you Start encoding. Rather, it waits for Helix Server to request 
the stream, which occurs when the first RealPlayer user requests the 
broadcast. For more information, refer to “Running a Pull Broadcast” on 
page 202. 


CBR Broadcasts 


Broadcasting constant bit rate (CBR) audio or video allows you to reach the 
widest audience on the Internet. As described in “SureStream CBR Clips” on 
page 61, you can use SureStream to encode the broadcast stream for multiple 
audiences. Each primary stream or substream you choose increases the 
processor load during encoding, however, and adds to the outgoing 
bandwidth requirements. 


If you choose the 56k Dial-up audience and the 128k Dual ISDN audience, for 
example, the encoding may require twice as much processing power. As well, 
the outgoing bandwidth available to RealProducer must be over 185 Kilobits 
per second. 
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Note: Except for those encoded with the lossless codec, all 
audio-only RealAudio streams are CBR and support the use of 
SureStream. 


VBR Broadcasts 


If you broadcast variable bit rate (VBR) video, you can choose one VBR 
audience for each output. Your outgoing RealProducer bandwidth, as well as 
your RealPlayer viewers’ network connections, should be able to handle the 
maximum bandwidth requirement for your selected audience, as listed in 
Chapter 7. For example, the 350k Download (VBR) audience has a maximum 
possible bandwidth of 700 Kilobits a second. 


Note: If you plan to broadcast a VBR stream, be sure that you 
understand VBR characteristics. See “VBR Clips for Streaming 
and Broadcasting” on page 65 for background. 


Broadcast Transport Protocols 


When you use a non-multicast, push broadcast method, you specify whether 
to use TCP or UDP when delivering the broadcast stream to Helix Server. UDP 
is the preferred protocol because of the lower network overhead. But you may 
want to use TCP when delivering the broadcast over a lossy environment. 


Note: The monitoring connection of an account-based 
broadcast always uses TCP whether the data transport stream 
is UDP or TCP. 


When RealProducer uses the connectionless UDP protocol, it does not receive 
notice that broadcast packets have arrived or are missing. This generally 
reduces the network communications overhead and improves the quality of 
the broadcast. Helix Server notifies RealProducer if it requires data to be 
resent. Thus, using UDP enhances the performance of your broadcast. 


A firewall between RealProducer and Helix Server may block UDP packets. 
The best solution is to configure the firewall to allow UDP packets through 
the ports that RealProducer and Helix Server use the broadcast transmission. 
These ports, which vary depending on the broadcast method, are described in 
the sections about setting up each type of broadcast in Chapter 11. 


CHAPTER 10: Planning a Broadcast 


TCP 


If you select the TCP protocol when broadcasting, RealProducer and Helix 
Server establish a two-way connection. If a broadcast packet is lost in 
transmission, the network itself requests the packet to be resent. This makes 
TCP a highly reliable protocol for broadcast on a network prone to high 
packet loss. It is also more likely to pass through firewalls that you cannot 
configure to accept UDP communications. 


Using TCP incurs a higher network and machine overhead, however, and can 
lead to inefficiencies. Helix Server does not need all stream packets to keep a 
broadcast flowing to RealPlayer. If a packet is lost, the network requests the 
packet again from RealProducer. That packet may no longer be available, 
however. Or, if it is available, it may arrive at Helix Server too late to be useful. 
Hence, both RealProducer and Helix Server must handle some network 
requests that do not benefit the broadcast. 


Video Startup Latency on RealPlayer 


Under normal conditions, Helix Server does not buffer the live stream input 
long before broadcasting it to viewers. When you broadcast RealVideo, 
however, RealPlayer must receive a video key frame before it displays the visual 
image. In the standard RealProducer encoding settings, it’s possible that a key 
frame does not display until ten seconds after the broadcast begins to play. 
The viewer therefore hears the soundtrack for ten seconds until the video’s 
visual track displays. 


As described in “Maximum Time Between Keyframes” on page 80, you can 
lower the maximum time between key frames to shorten this delay during a 
broadcast. However, this can reduce the compression gains of the RealVideo 
codec, resulting in a slower frame rate or lower visual quality. Note, too, that 
the delay can vary for each viewer depending on how often key frames are 
actually encoded into the stream and at which point the viewer joins the 
broadcast. 


SMIL in Broadcasts 


You can use SMIL 1.0 or SMIL 2.0 to add prerecorded content to a live 
broadcast. Within a SMIL file, you treat a broadcast like any other clip, 
furnishing a URL that points RealPlayer to the live stream instead of an on- 
demand clip. You can assign broadcast streams to SMIL regions to lay out the 
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presentation, and play a broadcast sequentially or in parallel with on-demand 
clips. 


SMIL can deliver an on-demand RealPix slide show along with live RealAudio, 
for example. It cannot synchronize the on-demand clip with the live stream, 
however. This is because the on-demand clip’s timeline starts when the viewer 
requests the presentation, whereas the broadcast stream’s timeline starts when 
the broadcast begins. 


To illustrate this, suppose that viewer A requests the presentation 2 minutes 
after the broadcast begins, and viewer B requests it 4 minutes after the 
broadcast begins. At 10 minutes into the broadcast, both viewers hear the 
same audio, but viewer A’s RealPix clip is at its 8-minute mark, whereas viewer 
B’s clip is at its 6-minute mark. Hence the relationship between the two 
timelines varies for each viewer. 


For More Information: For more on SMIL, see RealNetworks 
Production Guide. 


Broadcast Trial Runs 


When you broadcast live content, you don’t get a second chance. It’s good 
practice to perform a trial run to ensure that the equipment works properly 
and that the broadcast results are what you expect. Because you can’t edit a 
live broadcast the way you can a prerecorded file, it’s important to set your 
audio levels and plan your video shots carefully in advance. 


During both the trial run and the live broadcast, view the broadcast with 
RealPlayer and confirm that the quality is good. When RealPlayer connects, 
check that the content begins to play in a reasonable time, such as less than 15 
seconds for a push broadcast or 30 seconds for the first request of a pull 
broadcast. Display RealPlayer’s playback statistics to verify that the frame rate 
is adequate, and that packet loss is not excessive. 


When you broadcast using SureStream, you can change the RealPlayer 
bandwidth preferences to display different SureStream streams. If you 
experience problems during your trial run, you may need to reduce the 
number of streams. Or, you may need to run the encoder on a more powerful 
computer. 


For More Information: See “Broadcast Load Management” on 
page 174 for additional points about managing processor load 
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during a broadcast. Refer to Chapter 4 and Chapter 5 for tips 
about encoding audio and video in a live broadcast. 


Simulated Live Broadcasts 


The broadcasting techniques described in this chapter apply only to the 
broadcasting of live content. Using the Simulated Live Transfer Agent (SLTA) 
of Helix Server, you can broadcast static clips as if they were a live event. The 
effect is that of a radio station that broadcasts the same prerecorded songs to 
every listener at the same time. SLTA even allows you to define playlists that 
you can update during the broadcast. 


To use SLTA, you encode static clips as described in Chapter 6. All clips used 
in an SLTA broadcast must be encoded for the same audience or audiences. 
You then transfer the clips to Helix Server, set up an SLTA playlist, and run the 
SLTA utility from the Windows or UNIX command line. The chapter on 
simulated live broadcasts in Helix Server Administration Guide explains how to 
do this. 


Broadcast Distribution 


In the simplest method of broadcasting, you send a single stream to a single 
server through a push or pull broadcasting method. Or, you send a single 
stream to multiple computers through multicasting. RealProducer allows you 
to send multiple streams to multiple destinations, however. As well, Helix 
Server offers several features for forwarding streams to additional servers. The 
following sections describe methods for distributing broadcast streams to 
multiple points. 


Multiple Destinations 


Using RealProducer, you can define multiple server destinations for a single 
encoded output. This allows you to forward the same broadcast to more than 
one Helix Server. In push broadcasting, you define each destination explicitly. 
In pull broadcasting, a new destination is created each time a Helix Server 
pulls the broadcast from RealProducer. 


Each additional server destination that you define for an output adds to your 
outgoing bandwidth requirement. If your broadcast stream is 350 Kilobits, for 
example, sending it to a second destination increases the total bandwidth to at 
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least 700 Kilobits. Because the same stream is sent to each destination, using 
multiple destinations does not increase the processor load for live encoding. 


Parallel Outputs 


Using parallel outputs, you can encode two or more streams with different 
properties. For example, you might want to encode live audio as a low- 
bandwidth, SureStream CBR stream for dial-up modem users, and as a high- 
bandwidth VBR stream for cable modem users. Because the same encoded 
stream cannot be both CBR and VBR, you create two separate outputs. 


As shown in “Destinations and Outputs” on page 19, you can send each 
encoded output to the same server destination, or to different server 
destinations. If the same Helix Server broadcasts both streams, the streams 
must have different names. Your Web page then gives viewers the choice of a 
low-speed broadcast or a high-speed broadcast. 


Each output that you add increases the amount of processing power that 
RealProducer requires, so you need to ensure that your computer is fast 
enough to handle the load. The processing power required for each output 
depends on the audiences selected. A multi-rate SureStream encoding requires 
more processing than encoding for a single audience. As well, encoding video 
requires much more processing power than encoding audio-only input. 


For More Information: To set up parallel outputs, you create a 
job file as described in Appendix B. You then run the broadcast 
through the command-line application, which Chapter 14 
covers. 


Server Splitting 


Each Helix Server is limited in the number of viewers who can receiver the 
broadcast. These limits are based on the server license, as well as practical 
constraints such as the amount of outgoing bandwidth. For a large broadcast, 
you may need to use multiple Helix Servers to reach your anticipated 
audience. Although RealProducer can send a broadcast stream to multiple 
server destinations, it is often more efficient to have the servers forward (or 
split) the broadcast stream themselves. 
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One-to-Many Splitting 


RealProducer Transmitter 


Receivers 


The preceding illustration shows a simple splitting arrangement in which 
RealProducer sends a broadcast stream to one Helix Server acting as a 
transmitter. This server then splits the stream to three additional Helix Servers 
acting as receivers. The transmitter and receivers can each stream the broadcast 
to multiple viewers. 


The method by which RealProducer delivers the stream to a transmitter is 
entirely independent of the manner in which the transmitter splits the stream. 
For example, RealProducer may use an account-based push to contact the 
transmitter, whereas the transmitter splits the stream by multicasting to the 
various receivers. As well, the receivers may be set up to pull the stream from 
the transmitter, even though RealProducer pushes the broadcast stream to the 
transmitter. 


For More Information: Setting up a splitting arrangement 
requires the services of an experienced Helix Server 
administrator. For more information on available options, 
refer to the chapter on transmitters and receivers in Helix Server 
Administration Guide. 


Optional Broadcasting Features 


The following sections describe optional features that you can use when 
broadcasting to Helix Server. In some instances, the Helix Server 


administrator must enable or configure the feature on the server. 
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Encoder Redundancy 


When broadcasting through account-based or password-only push methods, 
you can provide encoder redundancy through two or more RealProducers 
encoding the same live event. When you start each broadcast stream, you 
specify the same stream name, but add a unique, numbered delimiter, such as 
.1 or .2. When the RealProducers connect to Helix Server, they form a queue 
based on connection order. Consider this example: 


live.rm.2 connects first 
live.rm.3 connects second 
live.rm.1 connects third 


Under normal circumstances all viewers receive the stream live.rm, and have no 
knowledge of which RealProducer encoded the stream. In the preceding 
example, live.rm originates as live.rm.2. If the RealProducer delivering live.rm.2 
fails, RealPlayers connect to the next live.rm stream in the queue, which is 
live.rm.3. If live.rm.2 returns, it goes to the bottom of the queue. A subsequent 
failure of live.rm.3 causes media players to connect to live.rm.1, and so on. 


RealProducer Redundancy 


live.rm.1 


RealProducer live.rm 


live.rm.2 


Helix Server RealPlayer 


RealProducer 


Note: Encoder redundancy is enabled automatically on Helix 
Server. Its use changes the broadcast URL, though. The Helix 
Server administrator may also require the use of a different 
delimiter, such as a tilde (~), in the stream identifier. Confer 
with the administrator on these issues before using encoder 
redundancy. 


Tip: To provide optimal redundancy, each encoder should be as 
independent as possible. For example, use multiple video 
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cameras connected to separate RealProducer computers that 
use different power supplies and network connections. 


For More Information: Refer to the unicasting chapter of Helix 
Server Administration Guide for information about encoder 
redundancy configuration options. 


Archiving 


When you broadcast a live event, you can also record the event to a clip for 
later, on-demand streaming. You can archive the clip through RealProducer, 
Helix Server, or both. A primary consideration is disk space. Writing a long 
broadcast to a clip can consume considerable disk space depending on the 
broadcast bandwidth. The server may have more available space than your 
RealProducer computer. As well, creating the archive on the server eliminates 
the need to upload the archive clip later if you want to stream it on demand. 


RealProducer Archiving 


To archive a broadcast on RealProducer, you define a clip destination along 
with the server destination. RealProducer automatically creates a new clip if 
the existing archive reaches the operating system limit (typically 2 or 4 
Gigabytes). If you run the broadcast from the command-line, or manually 
create a job file for the broadcast, you can specify a different file rolling limit 
based on broadcast time or file size. 


For More Information: The section “Creating a Destination Clip” 
on page 90 explains how to create an archive clip. For 
information on file rolling through the command line, see 
“Output and Destination Options” on page 261. The section 
“File Destinations” on page 320 explains how to define file 
rolling through a job file. 


Helix Server Archiving 


The Helix Server administrator can turn on archiving for RealMedia 
broadcasts. Like RealProducer, Helix Server can create multiple archive files 
based on the broadcast time (such as a new file every 15 minutes), or file size 
(20 Megabytes per file, for example). The administrator can also set up 
selective archiving rules that archive only certain broadcast streams based on 
the presence of a virtual path in the stream name. 
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For More Information: See the unicasting chapter of Helix Server 
Administration Guide for information about archiving. 


Virtual Paths 


When you encode a broadcast, you define a stream name such as live.rm. 
Optionally, you can precede the stream name with a a virtual path, as in 
news/live.rm. The virtual path does not correspond to any physical directory or 
mount point. Rather, it serves as a flag to Helix Server to apply certain rules 
for archiving or splitting. 

The Helix Server administrator can set up archiving rules based on the 
presence of virtual paths. For instance, the administrator may archive all 
broadcasts that include the news/ path in a certain directory, and all 
broadcasts that use the sports/ path in a different directory. A second use is 
with splitting, which the section “Server Splitting” on page 170 describes. The 
virtual path can define which broadcast streams are split to which receivers. 


Note: Confer with the Helix Server administrator about the 
path name to use. When you include the virtual path with the 
broadcast stream name, URLs to the broadcast must include 
the virtual path as well. 


For More Information: For information about server-side 
archiving rules, refer to the unicasting chapter in Helix Server 
Administration Guide. That manual’s chapter on transmitters 
and receivers explains splitting rules. 


Broadcast Load Management 
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When you broadcast live content, it is crucial that your RealProducer machine 
encode the input audio or video in real-time. Otherwise, the encoding process 
falls behind the input media and the broadcast stalls. RealProducer provides 
several features that automatically lowers the processing load as necessary. 
The following sections explain these load management features, and discuss 
the encoding options that you may want to avoid because of the processing 
power they require. 


Note: The number of SureStream audiences you choose for a 
constant bit broadcast greatly affects the processing 
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requirements. See “CBR Broadcasts” on page 165 for more 
information. 


Tip: You will get superior encoding results using a machine 
with two or more processors. The section “RealVideo Codecs” 
on page 60 explains how RealProducer manages multiple 
processors. No matter how fast of a machine you use, though, 
you should not run other, unnecessary applications or services 
on the RealProducer machine during a live broadcast. 


Broadcast Load Testing 


Before running a broadcast, you can test your RealProducer computer to 
determine if it can handle the processing load. 


Testing Load Levels with a Trial Broadcast 


The best way to do this is to run a test broadcast, as advised in the section 
“Broadcast Trial Runs” on page 168. During the broadcast, look for messages 
about load reduction and frame dropping printed to the command-line 
application screen or displayed in the log viewer. After the broadcast trial has 
completed, check the statistics to ensure that the average video frame rate was 
acceptable. 


For More Information: Refer to the sections “Viewing Log 
Messages” on page 147 and “Monitoring Statistics” on page 
144. 


Testing Load Levels through Clip Encoding 


If you do not have a Helix Server available for a broadcast load test, capture 
live input to a RealMedia clip as described in Chapter 6. Select the same 
options and audiences you plan to use in the broadcast. If RealProducer can 
encode the clip in less time than it takes the clip to play (for example, 45 


seconds to encode a 60-second video file), it can typically handle the broadcast 
load. 


Tip: When testing with a video clip, turn off two-pass encoding 
as described in “Choosing Video Options” on page 97. 
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Video Codecs and Encoding Complexity 


As noted in the section “Encoding Complexity Modes” on page 79, you can set 
a video complexity level of low, medium, and high. If you use the default setting 
of high, RealProducer automatically lowers the level if the encoding process 
cannot keep up with the video input. This scales down the video quality, but 
keeps the broadcast flowing. You therefore do not need to change the level 
manually when broadcasting unless you specifically want to reserve processing 
power for other applications on the RealProducer computer. 


By default, RealProducer uses RealVideo 10, which provides the highest video 
quality, but also requires the most processing power. For best results, stick 
with RealVideo 10 and let RealProducer reduce the encoding complexity 
automatically. If you use RealProducer Plus and still lack processing power, 
you can switch to RealVideo 9, which requires less processing power. 
RealVideo 8, in turn, requires less processing power than RealVideo 9. 


Tip: YUV12, also known as 1420, is the native color format used 
by RealVideo codecs. Capturing video input as 1420 improves 
performance by removing the need to convert the color format 
before encoding. 


Automatic Frame Rate Reduction 


If necessary, RealProducer scales down the encoded frame rate to keep up with 
the media input stream. Most audience settings specify a preferred frame rate 
of 15 or 30 frames per second. RealProducer attempts to provide the preferred 
rate, but encodes at a slower rate if necessary if the encoding process begins to 
maximize the CPU usage. Check the log viewer for reductions in frame rates. 
To keep the frame rate encoding adequate, you may need to eliminate other, 
CPU-intensive features, or broadcast using a faster computer. 


Note: RealProducer may also lower the encoded frame rate 
because of the bandwidth constraints of the chosen broadcast 
audience. The RealProducer log does not report these rate 
reductions because they do not result from CPU bottlenecks. 
The RealPlayer playback statistics panel lists the broadcast 
stream’s frame rates, however. 
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Video Filters, Resizing, and Cropping 


The section “RealVideo Filters” on page 74 explains the video prefilters that 
you can use during a broadcast. The black-level, de-interlace, and low noise 
filters are relatively safe to use because of their low processing needs. Resizing 
a video is highly processor intensive and should not be used when 
broadcasting. However, cropping a video can speed the encoding process 
because it decreases the amount of video data that must be encoded. 


Tip: When possible, use the video capture card to set the video 
input to the appropriate size. Resizing through hardware is 
generally faster than resizing through software. See “Video 
Encoding Dimensions” on page 71 for tips about selecting the 
video height and width. 


Audio Resampling 


RealAudio codecs require audio input to have a certain sampling rate. If 
necessary, RealProducer resamples the audio to the necessary rate before 
encoding. It is helpful to avoid resampling by ensuring that your audio input 
uses a preferred sampling rate. See “Sampling Rate” on page 36 for details. 


Visual Monitoring 


If you use the RealProducer graphical application to run the broadcast, 
RealNetworks highly recommends that you turn off the visual display of the 
input video and encoded output to lessen the processor load. Refer to the 
section “Monitoring Video Output” on page 144 for instructions. 
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11 


RUNNING A BROADCAST 


This chapter explains how to set up a broadcast by defining server 
destinations and templates. The procedure differs depending on the 
type of broadcast you are performing. Refer to Chapter 10 for 


background about broadcasting options. 


Tip: You can also encode the output as an archive clip during 
the broadcast. The section “Creating a Destination Clip” on 
page 90 explains how to do this. 


Running an Account-Based Broadcast 


Account-based, push broadcasting provides easy set-up and reliable delivery of 
the broadcast stream. It allows you to send a stream to Helix Server version 9 
or later. In this method, RealProducer maintains a monitoring connection to 
Helix Server. This connection allows it to pass a user name and password to 
authenticate access to the server. Helix Server uses this connection to send 
statistics about the broadcast stream back to RealProducer. 


For More Information: Refer to the section “Running an 
Account-Based Broadcast” on page 179 for set-up instructions. 


Advantages of Account-Based Broadcasting 


Because of its monitoring connection, account-based broadcasting is a good 
method to use if you do not have access to the monitoring pages on Helix 
Server. The feedback from the monitoring connection informs you if the 
access attempt failed because of an invalid password, for instance. It also 
informs you if the connection between RealProducer and the server was 
dropped and automatically restarted. 


Setting up an account-based broadcast requires a minimal amount of 
knowledge about how Helix Server is configured. You need to know the server 
IP address, and have a valid user name and password for an encoder login 
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defined by the Helix Server administrator in the server’s authentication 
database. 


Account-Based Broadcast Steps 


The following figure illustrates the interaction between RealProducer, Helix 
Server, and RealPlayer in an account-based broadcast. 


Account-Based, Push Broadcast 


Initial 
Connection 
4 Request 
wen ae-4 -=)_.45.__-= 
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RealProducer Helix Server RealPlayer 


1. RealProducer establishes its monitoring connection with Helix Server. 
Using this connection, RealProducer sends a user name and password 
that authenticates its attempt to access the server. 


2. After Helix Server authenticates the broadcast, it informs RealProducer 
how to make the broadcast connection, telling it which server ports to use, 
for example. 


3. RealProducer establishes the broadcast stream connection to Helix Server. 
It begins to send the encoded packets, whether or not any RealPlayer users 
have requested the broadcast yet. 


4. A viewer typically requests the broadcast by clicking a link in a Web page. 
This launches RealPlayer, which requests a broadcast stream from Helix 


Server. 


5. Helix Server streams the broadcast to RealPlayer. 


Preparing Helix Server for an Account-Based Broadcast 


Helix Server requires minimal configuration to receive and distribute an 
account-based broadcast. Confer with the server administrator on the 
following issues, which are covered in the unicasting chapter of Helix Server 
Administration Guide: 
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+ RealProducer requires a valid user name and password. These values are 
defined in the Helix Server authentication database under the 
SecureRBSEncoder realm. If you previously broadcasted using RealProducer 
8.5 or earlier, your user name and password were defined under a different 
authentication realm and will not work with RealProducer 10. 


Tip: If you are the Helix Server administrator, you can connect 
using the user name and password for Helix Administrator. 
For greater security, however, define a different user name and 
password for RealProducer. 


The broadcast requires at least two ports on Helix Server for the stream 
data, whether you use TCP or UDP. RealProducer and Helix Server 
negotiate which ports to use. Possible ports are in the range 50001 to 
50050 unless the Helix Server administrator changes the range. 


Tip: If you select UDP transport, ensure that any firewalls 
between RealProducer and Helix Server allow UDP data sent to 
Helix Server on the ports in the defined range. If you are 
broadcasting through a firewall performing network address 
translation (NAT), you may need to set the RealProducer listen 
address to the IP address of the firewall or the value 0.0.0.0. See 
“Listen Address” on page 196. 


If you want to archive or split the broadcast on Helix Server, you may need 
to apply archiving or splitting rules. This requires that the Helix Server 
administrator define the rules for a specific virtual path that precedes the 
stream name, as in news/live.rm. For background, refer to “Virtual Paths” 
on page 174. 


If you plan to use redundant encoders, verify the stream delimiter 
expected by Helix Server. This is typically a period, as in live.rm.1 and 
live.rm.2. For more on this topic, see “Encoder Redundancy” on page 172. 


+ The URL for the broadcast varies depending on the Helix Server features, 
such as viewer authentication, that you use. The section “Standard URL 
for a Push Broadcast” on page 209 explains the basic URL format. 


Although RealProducer receives statistics about the broadcast stream, it 
does not receive statistics about the actual broadcast, such as how many 
RealPlayer viewers connected and how long they watched. Depending on 
the method Helix Server uses to broadcast the stream to the players, as 
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well as the server logging parameters, the server log files may record these 
statistics. 


Defining the Account-Based Server Destination 


This section explains how to define the account-based broadcast on 
RealProducer. You can create the server destination anytime before the 
broadcast, and can save the settings to a template for future use. You'll need 
the following information about Helix Server: 


¢ Helix Server IP address or DNS name 
- Helix Server HTTP port number 


- valid user name defined in the SecureRBSEncoder realm of the Helix Server 
authentication database 


- valid password for the user name 
> To set up an account-based server destination: 


1. If you have multiple jobs open, click the appropriate job file name in the 
job manager. 


2. Select File>Add Server Destination to display the server destination dialog. 
Or, click the server icon in the destinations area. 


3. Enter a description of the server in the Destination Name field. This is for 
your reference only and does not affect the broadcast. If you save the 
destination as a template, this entry becomes the name of the template in 


the graphical application, as well as the file name of the server destination 
file. 


4. In the Stream Name field, enter a name for the broadcast stream. This 
name resembles a clip name and should use the appropriate extension, 
either .rm for a constant bit rate stream or .rmvb fora variable bit rate 
stream. This name appears in the broadcast URL. 


The stream name can include uppercase or lowercase letters, numbers, an 
underscore (_), and a dash (-). Spaces are not allowed. If you are using 
encoder redundancy, include the appropriate stream delimiter and a 
unique number for this encoder: 


live.rm.2 


5. From the Broadcast Method pull-down list, select Push, Account-Based 
Login (Helix Server). 
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6. For Server Address, enter the IP address or DNS name of the Helix Server 


10. 


11. 


12. 


13. 


used for the broadcast, such as 207.188.7.176 or helixserver.example.com. 


. The optional Path field specifies a virtual path that can be used for 


archiving or splitting on Helix Server. Use a simple name followed by a 
forward slash, such as news/. 


. For Port, specify the HTTP port on Helix Server. The default value is port 


80, which is the server’s default HTTP port. For account-based 
broadcasting, RealProducer uses its monitoring connection to contact 
Helix Server on this port and deliver the broadcast stream information. 
RealProducer and Helix Server then negotiate which UDP or TCP ports to 
use for the broadcast data. 


. In the Username and Password fields, enter a valid encoder user name and 


password defined in Helix Server’s authentication database. The 
broadcast connection fails if either value is incorrect. If you are saving the 
destination as a template, you can click Remember password to store the 
user name and password in the template file. 


Warning! The password is saved as plain text in the job file or 
the server template. If you save the password, be sure that you 
maintain appropriate security on these files. 


Under Transport, click the radio button for UDP or TCP to select the type of 
protocol to use for the broadcast stream. UDP is preferred, but may be 
blocked by firewalls. See “Broadcast Transport Protocols” on page 166 for 
descriptions of TCP and UDP. 


You may want to set the advanced broadcast options by clicking the 
Advanced Options button. See “Changing Advanced Push Broadcast 
Parameters” on page 194 for more information. 


To save the server destination as a template, click the Templates button 
and select Save as Template. You can then use this server destination for 
future broadcasts, as described in “Working with Server Templates” on 
page 207. 


Click OK to save the server destination. The destination appears in the 
destinations section of the RealProducer main window. You can right- 
click the destination name to edit or delete the destination. 
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Starting and Stopping an Account-Based Broadcast 


When you have completed the server destination and have defined the live 
input as described in “Using Live Audio or Video as the Input” on page 88, you 
can start the broadcast by clicking the Encode button. RealProducer 
immediately begins to encode the live input, sending the broadcast stream to 


Helix Server. 


If configured to do so, the account-based broadcast method automatically 
reconnects a dropped broadcast stream. Because of its monitoring connection, 
RealProducer receives broadcast statistics and notification if Helix Server has 
stopped the broadcast. If the server stops the broadcast, RealProducer 
terminates the stream and stops the encoding process. You can also terminate 
the broadcast by clicking the Stop button. 


For More Information: See “Monitoring Statistics” on page 144 
for information about monitoring a broadcast in progress. 


Setting Up a Password-Only Broadcast 
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Unlike account-based broadcasting, password-only broadcasting does not 
establish a monitoring connection. It therefore incurs less network overhead, 
but it receives no feedback from Helix Server. This broadcast method allows 
you to send a live stream to Helix Server version 9 or later. You must set up the 
server as a receiver in a splitting arrangement, however. 


Advantages of Password-Only Broadcasting 


Because it sets up no monitoring connection between RealProducer and Helix 
Server, password-only broadcasting requires less bandwidth and processor 
power on the RealProducer machine. This makes the broadcast more efficient, 
especially if you have multiple server destinations. Password-only broadcasting 
also lightens the load on Helix Server because the server does not need to 
generate broadcast statistics for RealProducer. 


A password-only broadcast re-establishes its connection automatically. If the 
broadcast connection fails for some reason, RealProducer continues to send 
the stream to Helix Server. It automatically encodes the broadcast metadata 
(such as the stream name) and password into the stream every at regular 
intervals. This allows Helix Server to re-establish the broadcast once it begins 


to receive the stream data again. 
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For More Information: The section “Metadata Resend Interval” 
on page 195 explains the advanced parameter that affects how 
long it takes Helix Server to re-establish a dropped broadcast 


stream. 


Disadvantages of Password-Only Broadcasting 


Password-only broadcasting is recommended only when you operate both 
RealProducer and Helix Server. Each broadcast stream protected by a unique 
password requires a separate receiver definition on Helix Server. This 
broadcasting method therefore requires more Helix Server configuration than 
does account-based broadcasting. Because the server provides no feedback, it 
is impossible to verify from RealProducer if the log-in attempt failed. You can 
use Helix Server’s monitor, however, to determine if the broadcast connection 
has been established. 


Password-Only Broadcast Steps 


The following figure shows the interaction between RealProducer, Helix 
Server, and RealPlayer in a password-only broadcast. 


Password-Only, Push Broadcast 


Request 


oO _.F__. 


RealProducer Helix Server RealPlayer 


1. As soon as it starts encoding the broadcast stream, RealProducer sends 
the stream packets to the Helix Server address. It receives no feedback that 
the broadcast packets have been received, encoding the stream metadata 
and server login password into the stream at regular intervals. 


2. A viewer typically requests the broadcast by clicking a link in a Web page. 
This launches RealPlayer, which requests a broadcast stream from Helix 


Server. 


3. Helix Server delivers the broadcast to RealPlayer. 
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Preparing Helix Server for Password-Only Broadcasting 


In a password-only broadcast, RealProducer acts as a transmitter and Helix 
Server functions as a receiver in a splitting arrangement. This highly robust 
configuration requires coordinated set-up on both ends. The chapter on 
transmitters and receivers in Helix Server Administration Guide explains 
splitting, and shows how to set up the server as a receiver. Before running a 
password-only broadcast, confer with the server administrator on the 
following issues: 


- To be configured as a receiver, Helix Server must be licensed for broadcast 
distribution. Clicking the About link in Helix Administrator displays the 
Helix Server licensing information. 


+ To connect to the Helix Server receiver, RealProducer transmits a 
password. Unlike with account-based broadcasts, this password is not 
defined in the Helix Server authentication database. Rather, the receiver 
configuration defines an authentication type of Basic and sets the 
password. The Helix Server administrator will need to supply you with the 
password to use. 


Note: Optionally, the receiver can require no authentication. In 
this case, you leave the password field in RealProducer blank. 
Unsecured transmission should be used only if RealProducer 
and Helix Server are on the same local network and a firewall 
blocks attempts by encoders outside the firewall to reach Helix 
Server. 


- Both RealProducer and the receiver need to define the same range of ports 
on Helix Server used for stream data. Default ports for both machines are 
30001 to 30020, but you may need to change this range depending on the 
receiver definition. When the broadcast begins, RealProducer and Helix 
Server negotiate which ports in this range to use. 


Tip: If you use the UDP transport, ensure that any firewalls 
between RealProducer and Helix Server allow UDP data sent to 
Helix Server on the ports in the defined range. If you are 
broadcasting through a firewall performing network address 
translation (NAT), you may need to set the RealProducer listen 
address to the IP address of the firewall or the value 0.0.0.0. See 
“Listen Address” on page 196. 
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+ The Helix Server receiver definition must specify the RealProducer IP 
address as the transmitter source, and indicate whether TCP or UDP is 
used. RealProducer must specify the same protocol in its server 
destination. 


Because this broadcast method does not provide feedback from Helix 
Server, there is no way to verify from RealProducer that the server has 
received the stream. Helix Server has a monitor that indicates encoder 
connections, however. 


- If you want to archive or split the broadcast on Helix Server, you may need 
to apply archiving or splitting rules. This requires that the Helix Server 
administrator define the rules for a specific virtual path that precedes the 
stream name, as in news/live.rm. For background, refer to “Virtual Paths” 
on page 174. 


- If you plan to use redundant encoders, verify the stream delimiter 
expected by Helix Server. This is typically a period, as in live.rm.1 and 
live.rm.2. For more on this topic, see “Encoder Redundancy” on page 172. 


- The URL for the broadcast varies depending on the Helix Server features, 
such as viewer authentication, that you use. The section “Standard URL 
for a Push Broadcast” on page 209 explains the basic URL format. 


Depending on the Helix Server logging parameters and the method it uses 
to broadcast the stream to RealPlayer viewers, broadcast statistics (such as 
the total number of viewers and how long each viewer watched) may be 
recorded in the server log files. 


Defining a Password-Only Server Destination 


This section explains how to define a password-only broadcast on 
RealProducer. You can create the server destination anytime before the 
broadcast, and can save the settings to a template for future use. You'll need 
information about the Helix Server receiver configuration: 


- Helix Server IP address or DNS name 
* receiver port range 
* UDP or TCP transport 


+ server log-in password defined in the receiver configuration 
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» To define a password-only server destination: 


1. If you have multiple jobs open, click the appropriate job file name in the 


job manager. 


. Select File>Add Server Destination to display the server destination dialog. 


Or, click the server icon in the destinations area. 


. Enter a description of the server in the Destination Name field. This is for 


your reference only and does not affect the broadcast. If you save the 
destination as a template, this entry becomes the name of the template in 
the graphical application, as well as the file name of the server destination 
file. 


. In the Stream Name field, enter a name for the broadcast stream. This 


name resembles a clip name and should use the appropriate extension, 
either .rm for a constant bit rate stream or .rmvb for a variable bit rate 
stream. This name appears in the broadcast URL. 


The stream name can include uppercase or lowercase letters, numbers, an 
underscore (_), and a dash (-). Spaces are not allowed. If you are using 
encoder redundancy, include the appropriate stream delimiter and a 
unique number for this encoder: 


live.rm.2 


. From the Broadcast Method pull-down list, select Push, Password-Only Login 


(Helix Server). 


. For Server Address, enter the IP address or DNS name of the Helix Server 


used for the broadcast, such as 207.188.7.176 or helixserver.example.com. 


. The optional Path field specifies a virtual path that can be used for 


archiving or splitting on Helix Server. Use a simple name followed by a 
forward slash, such as news/. 


. For Port Range, indicate the range of ports on Helix Server where 


RealProducer sends the broadcast packets (either TCP or UDP). 
RealProducer and Helix Server negotiate the actual ports to use once the 
broadcast begins. The default range is 30001 to 30020. 


. In the Password field, enter the password set in the Helix Server receiver 


definition. The broadcast connection fails if the value is incorrect. If you 
are saving the destination as a template, you can click Remember password 
to store the password in the job file or server template file. 
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Warning! The password is saved as plain text in the job file or 
the server template. If you save the password, be sure that you 
maintain appropriate security on these files. 


10. Under Transport, click the radio button for UDP or TCP to select the 
protocol used for the broadcast stream. UDP is preferred, but may be 
blocked by firewalls. See “Broadcast Transport Protocols” on page 166 for 
descriptions of TCP and UDP. 


11. You may want to set the advanced broadcast options by clicking the 
Advanced Options button. See “Changing Advanced Push Broadcast 
Parameters” on page 194 for more information. 


12. If you want to save the server destination as a template, click the 
Templates button and select Save as Template. You can then use this server 
destination for future broadcasts, as described in “Working with Server 
Templates” on page 207. 


13. Click OK to save the server destination. The destination appears in the 
destinations section of the RealProducer main window. You can right- 
click the destination name to edit or delete the destination. 


Starting and Stopping a Password-Only Broadcast 


When you have completed the server destination and have defined the live 
input as described in “Using Live Audio or Video as the Input” on page 88, you 
can start the broadcast by clicking the Encode button. RealProducer 
immediately begins to encode the live input, sending the broadcast stream to 
Helix Server. 


The password-based broadcast method automatically reconnects a dropped 
broadcast stream. Because it maintains no monitoring connection with Helix 
Server, however, RealProducer does not receive notice if Helix Server stops the 
broadcast. You can terminate the broadcast from RealProducer by clicking the 
Stop button. 


Multicasting a Live Stream 


In a multicast, RealProducer Plus can deliver the same broadcast stream to any 
number of Helix Servers without increasing its outgoing bandwidth. In non- 
multicast delivery (multiple server destinations with password-only 
broadcasting, for example), each server receives a separate stream, adding to 
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RealProducer’s bandwidth requirement. The following figure illustrates 
multicasting, which is available with Helix Server version 9 and later. 
Multicasting is not available with RealProducer Basic. 


Multicast Push 


RealProducer Helix Servers 


Multicasting requires that your RealProducer, Helix Servers, and all network 
equipment such as routers be multicast-enabled, which is often possible on a 
local area network (LAN). Multicasting may not be possible if RealProducer or 
any of the Helix Servers needs to communicate to another broadcast 
component across the Internet. Confer with your network administrator and 
Helix Server administrator to determine if multicasting is available. 


Tip: Multicast broadcasting can also be used for broadcasting 
across a one-way satellite network where two-way connections 
are not possible. 


Preparing Helix Server for a Multicast 


In a multicast, RealProducer acts as a transmitter and the Helix Servers 
function as receivers in a splitting arrangement. This configuration requires 
coordinated set-up on both ends. The chapter on transmitters and receivers in 
Helix Server Administration Guide explains splitting, and shows how to set up 
each server as a receiver. Before configuring a multicast, confer with the server 
administrator on the following issues: 


- To be configured as a multicast receiver, each Helix Server receiver must be 
licensed for broadcast distribution. Clicking the About link in Helix 
Administrator displays the Helix Server licensing information. 


- A multicast requires the use of a continuous range of multicast addresses 
on your network. These addresses are in the range 224.0.0.0 to 
239.255.255.255. 
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To connect to the Helix Server receivers, RealProducer transmits a 
password. Unlike with account-based broadcasts, this password is not 
defined in the Helix Server authentication database. Rather, the receiver 
configurations define an authentication type of Basic and set the 
password. The Helix Server administrator will need to supply you with the 
password to use. 


Note: Optionally, the receivers can require no authentication. 
In this case, you leave the password field on RealProducer 
blank. Unsecured transmission should be used only if 
RealProducer and the Helix Servers are on the same local 
network and a firewall blocks attempts by encoders outside the 


firewall to reach the Helix Server receivers. 


Both RealProducer and the Helix Servers define the same range of ports 
on the receivers used for stream data. Default ports are 30001 to 30020, 
but you may need to change this range depending on the receiver 
definitions. When the broadcast begins, RealProducer and the Helix 


Server receivers negotiate which ports to use. 


Note: Ensure that any firewalls between RealProducer and 
Helix Server allow multicast, UDP data sent to the Helix 
Servers on the ports in the defined range. 


The receiver definition on each Helix Server defines the RealProducer IP 
address as the transmitter source, and must specify that udp/multicast is 
used as the transport. 


If you want to archive or split the broadcast on Helix Server, you may need 
to apply archiving or splitting rules. This requires that the Helix Server 
administrator define the rules for a specific virtual path that precedes the 
stream name, as in news/live.rm. For background, refer to “Virtual Paths” 
on page 174. 


If you plan to use redundant encoders, verify the stream delimiter 
expected by Helix Server. This is typically a period, as in live.rm.1 and 
live.rm.2. For more on this topic, see “Encoder Redundancy” on page 172. 


The URL for the multicast varies depending on the Helix Server features, 
such as viewer authentication, that you use. The section “Standard URL 
for a Push Broadcast” on page 209 explains the basic URL format. 
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+ Depending on the Helix Server logging parameters and the method it uses 
to broadcast the stream to RealPlayer viewers, broadcast statistics (such as 
the total number of viewers and how long each viewer watched) may be 
recorded in the server log files. 


Defining a Multicast Server Destination 


This section explains how to define a multicast server destination on 
RealProducer. You can create the server destination anytime before the 
multicast, and can save the settings to a template for future use. You'll need 
the following information about the Helix Server receivers and network 
multicast configuration: 


¢ multicast address 
* port ranges on the receivers 


+ password on the receivers 


> To define a multicast server destination: 


1. If you have multiple jobs open, click the appropriate job file name in the 


job manager. 


. Select File>Add Server Destination to display the server destination dialog. 
Or, click the server icon in the destinations area. 


. Enter a description of the server in the Destination Name field. This is for 
your reference only and does not affect the broadcast. If you save the 
destination as a template, this entry becomes the name of the template in 


the graphical application, as well as the file name of the server destination 
file. 


. In the Stream Name field, enter a name for the broadcast stream. This 
name resembles a clip name and should use the appropriate extension, 
either .rm for a constant bit rate stream or .rmvb fora variable bit rate 
stream. This name appears in the broadcast URL. 


The stream name can include uppercase or lowercase letters, numbers, an 
underscore (_), and a dash (-). Spaces are not allowed. If you are using 
encoder redundancy, include the appropriate stream delimiter and a 
unique number for this encoder: 


live.rm.2 
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5. From the Broadcast Method pull-down list, select Push, Multicast (Helix 
Server). 


6. For Multicast Address, enter the multicast address for the broadcast 
stream. It must be in the range 224.0.0.0 to 239.255.255.255. 


7. The optional Path field specifies a virtual path that can be used for 
archiving or splitting on Helix Server. Use a simple name followed by a 
forward slash, such as news/. 


8. For Port Range, indicate the range of ports on the Helix Server receivers 
where the broadcast packets will be sent. RealProducer and Helix Server 
negotiate the actual ports to use once the broadcast begins. The default 
range is 30001 to 30020. 


9. In the Password field, enter the password defined in each Helix Server 
receiver definition. The broadcast connection fails if the value is incorrect. 
If you are saving the destination as a template, you can click Remember 
password to store the password in the job file or server template file. 


Warning! The password is saved as plain text in the job file or 
the server template. If you save the password, be sure that you 
maintain appropriate security on these files. 


10. You may want to set the advanced broadcast options by clicking the 
Advanced Options button. See “Changing Advanced Push Broadcast 
Parameters” on page 194 for more information. 


11. If you want to save the destination as a template, click the Templates 
button and select Save as Template. You can then use this destination for 
future multicasts, as described in “Working with Server Templates” on 
page 207. 


12. Click OK to save the server destination. The destination appears in the 
destinations section of the RealProducer main window. You can right- 
click the destination name to edit or delete the destination. 


Starting and Stopping a Multicast 


When you have completed the server destination and have defined the live 
input as described in “Using Live Audio or Video as the Input” on page 88, you 
can start the multicast by clicking the Encode button. RealProducer 


193 


RealProducer 10 User’s Guide 


immediately begins to encode the live input, sending the broadcast stream to 
Helix Server. 


A multicast automatically reconnects a dropped broadcast stream based on 
the metadata resend interval. Because it maintains no monitoring connection 
with the Helix Server receivers, however, RealProducer does not receive notice 
if the receivers stop the broadcast. You can terminate the broadcast from 
RealProducer by clicking the Stop button. 


Changing Advanced Push Broadcast Parameters 
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In the Server Destination dialog, clicking the Advanced Options button displays 
a dialog in which you can configure the advanced settings for an account- 
based, password-only, or multicast push broadcast. These settings primarily 
affect how RealProducer attempts to reconnect to Helix Server if the broadcast 
stream is dropped, and how it protects the broadcast stream against lost data. 
You may want to leave these options set to their default values at first, 
modifying them only if you experience disconnects or lost data between 
RealProducer and Helix Server. 


Note: No advanced options are available for legacy push 
broadcasting. For pull broadcasting, Helix Server defines the 
error correction and metadata rates. You can set a single 
advanced pull broadcasting parameter as described in 
“Defining a Pull Broadcast Server Destination” on page 205. 


TCP Reconnect 


The TCP reconnection option is on by default. It affects the reconnection 
method for account-based broadcasts, which use a TCP monitoring channel. 
It also controls the reconnection method for password-only broadcasting if 
you have chosen TCP rather than UDP as the broadcast protocol. In the server 
definition file, the enableTCPReconnect property enables TCP reconnection. 


The TCP reconnection interval sets the number of seconds that RealProducer 
waits before attempting to reconnect to Helix Server. The interval period 
begins when the operating system terminates the TCP connection because it 
has received no response from Helix Server. In the graphical application, you 
set this value in the Time between attempts field. In the server destination file, 
the TCPReconnectInterval property sets the value. Choose a value in seconds of 1 
second or higher. A value of 0 is not valid. The default value is 10. 
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Metadata Resend Interval 


The metadata resend interval affects how RealProducer and Helix Server re- 
establish a dropped broadcast stream in password-only and multicast 
broadcasts that use UDP as the transport. When RealProducer communicates 
to Helix Server solely through UDP, it does not receive feedback from the 
server and therefore cannot know if a broadcast stream has been dropped. 


To protect against stream loss, RealProducer periodically encodes metadata 
into the broadcast stream. This provides the information that Helix Server 
needs to restart the stream, such as the stream name and the receiver 
password. Through the graphical application’s Metadata resend interval field, 
or the server destination file’s metadataResendInterval property, you specify 
how frequently RealProducer encodes metadata into the stream. This value 
determines the approximate, maximum time that viewers may need to wait for 
RealPlayer to reconnect to a dropped broadcast. The default is 30 seconds. 


Note: The metadata resend interval has no effect on password- 
only broadcasts that use TCP transport. For these broadcasts, 
as well as for account-based broadcasts, the TCP reconnection 
values described in “TCP Reconnect” on page 194 control the 
reconnection characteristics. 


Statistics Update Interval 


The statistics update interval determines how frequently Helix Server sends 
statistics reports to RealProducer during an account-based broadcast. It is not 
used with any other broadcast method. Set a value in seconds in the graphical 
application’s Server statistics update... field or through the server destination 
file’s statisticsUpdateInterval property. The default value is 10 seconds. 


Packet Resend Requests and Listen Address 


If Helix Server does not receive broadcast packets, it first attempts to 
reconstruct the broadcast data using the forward error correction packets, as 
described in “Forward Error Correction” on page 196. If that fails, it can 
request RealProducer to resend the packets. There is no guarantee, however, 
that RealProducer will still have the packets buffered or that they will arrive in 
time to be useful for the broadcast. The resend feature functions with 
account-based and password-only broadcasts that use the UDP transport. It is 
ignored for broadcasts that use a TCP transport, as well as multicasts. 
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Packet Resends 


The packet resend feature is turned on by default. Because the resend requests 
increase network overhead slightly, you may want to turn the resend feature 
off to keep tight control over network bandwidth use. To do so, uncheck the 
packet resend option in the graphical application, or set a value of False for the 
allowResends property in the server destination file. 


Note: The Helix Server receiver configuration can turn off the 
feature for making resend requests. In this case, the 
RealProducer setting has no effect because the server will never 
make these requests. 


Listen Address 


The listen address sets the IP address that RealProducer uses to listen for 

packet resend requests from Helix Server. If your RealProducer machine has 
multiple IP addresses, choose an IP address from the graphical applicatino’s 
Listen address drop-down list, or enter the IP address manually. In the server 
destination file, add the IP address as the value of the listenAddress property. 


Tip: If you are broadcasting through a firewall performing 
network address translation (NAT), set the listen address to the 
IP address of the firewall or the value 0.0.0.0. The 0.0.0.0 value 
tells Helix Server to allow a RealProducer connection from any 
IP address. The connection still requires the valid password, 
however. 


Forward Error Correction 


When forward error correction (FEC) is used, RealProducer adds error 
correction packets to the broadcast stream. If packets containing broadcast 
data are lost, Helix Server can often reconstruct the data using the error 
correction packets. You can include forward error correction with broadcasts 
that use the UDP transport. The setting is ignored for any broadcast that uses 
TCP for data transport. 


If you use forward error correction, the value set in the graphical application’s 
Partial stream redundancy field or through the server destination file’s 
fecPercent field indicates the percentage of the broadcast stream dedicated to 
forward error correction. The greater the value, the higher the packet loss 
protection and the greater the bandwidth needs for the stream. A standard 
value of 20 percent means that one in five packets is for error correction. The 
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stream also uses 20 percent more bandwidth than if error correction were 
turned off. 


Note: Using FEC increases the bandwidth only for the stream 
between RealProducer and Helix Server. It does not affect the 
bandwidth of the broadcast streams delivered to RealPlayer 
viewers by Helix Server. 


Tip: Forward error correction is most useful when sending a 
broadcast stream over a lossy network such as the Internet. If 
your RealProducer and Helix Server are on the same local area 
network, you may not need to use any error correction. 


For More Information: If the packet reconstruction fails, Helix 
Server may request the lost packets to be sent again, as 
described in “Packet Resend Requests and Listen Address” on 
page 195. 


Redundant Stream Protection 


You can turn FEC protection all the way up to 100%, effectively creating a 
redundant stream that provides maximum protection against packet loss. 
This doubles the outgoing bandwidth required for the broadcast stream, 
however. To do this through the graphical application, click the Full stream 
redundancy radio button. If you are editing the server destination file 
manually, set the value of the fecPercent property to 100. 


When you use full stream redundancy, you can set an offset in seconds 
between each packet and its redundant packet. This reduces the chance that 
both packets will be lost. For example, an offset value of 2 means that after it 
transmits a certain packet to Helix Server, RealProducer waits two seconds 
before transmitting the redundant packet. To set this offset, enter a value in 
seconds in the graphical application’s Redundant packet latency field. In the 
server destination file, the fecOffset property controls this setting. 


Note: Implementing packet redundancy is not the same as 
using redundant RealProducers, which is described in 
“Encoder Redundancy” on page 172. Packet redundancy 
protects against losses due to network conditions, but it does 
not protect against the failure of the encoding process as does 
encoder redundancy. 
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FEC Rates and Receiver Buffering 


When you use forward error correction, the Helix Server administrator may 
need to increase the amount of time that the receiver buffers the broadcast 
stream. If an FEC packet arrives after the server broadcasts the portion of the 
stream that the FEC packet corrects, the packet is useless. The administrator 
may need to change the buffering whether you use partial or full stream 
redundancy: 


- If you use full stream redundancy, Helix Server must buffer the stream at 
least as long as the redundant packet offset value. For example, if 
RealProducer transmits redundant stream packets five seconds after the 
initial stream packets, the Helix Server receiver needs to buffer the stream 
for a minimum of five seconds. 


+ When you use partial stream redundancy, broadcasting low-bandwidth 
RealVideo streams with an error correction rate lower than 20 percent 
may require raising the receiver buffering time. The chapter on 
transmitters and receivers in Helix Server Administration Guide explains how 
to set the receiver buffering based on the transmitter FEC rate. 


Multicast Time to Live 


All multicast broadcasts include a “time to live” feature. As a multicast data 
packet passes through a multicast-enabled router, its time to live decreases by 
1. When the value reaches 0, the router discards the data packet. When you set 
up a multicast, you specify a time to live of 0 to 255 in the Multicast time to live 
field or the server destination file’s multicastTTL property. The larger the value, 
the greater the distance a packet can travel. The default value of 16 typically 
keeps multicast packets within an internal network. The following table 
summarizes possible values. 


Time to Live (TTL) Values 
TTL Value Packet Range 


0) local host 

1 local network (subnet) 
16 intranet 

32 site 

64 region 


(Table Page 1 of 2) 
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Time to Live (TTL) Values (continued) 
TTL Value Packet Range 


128 continent 


255 world 


(Table Page 2 of 2) 


Setting up a Legacy Broadcast 


The legacy push method is similar to the account-based push method. It does 
not use a monitoring connection to provide server feedback and statistics, 
however, and is not as robust a broadcast method as account-based push. Use 
this broadcast method only when sending a broadcast stream to a server that 
predates Helix Server version 9, such as RealSystem Server G2, 7, or 8. You 


cannot broadcast variable bit rate (VBR) streams using the legacy push 
method. 


Preparing RealSystem Server for Legacy Broadcasting 


RealSystem Server requires minimal configuration to receive and distribute an 
legacy broadcast. Confer with the server administrator on the following issues: 


+ RealProducer requires a valid user name and password. These values are 
defined in the RealSystem Server authentication database under the 
SecureEncoder realm. 


Tip: If you are the RealSystem Server administrator, you can 
connect using the user name and password for RealSystem 
Server Administrator. For greater security, however, define a 
different user name and password for RealProducer. 


+ RealSystem Server defines a port that it uses to listen for incoming 
broadcasts. This is port 4040 by default, but may be changed by the server 
administrator. RealProducer must define the same port in its server 
destination. 


- If you want to archive or split the broadcast on RealSystem Server, you 
may need to apply archiving or splitting rules. This requires that the 
RealSystem Server administrator define the rules for a specific virtual 
path that precedes the stream name, as in news/Live.rm. For background, 
refer to “Virtual Paths” on page 174. 
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- The URL for the broadcast varies depending on the RealSystem Server 
features, such as viewer authentication, that you use. The section 
“Standard URL for a Push Broadcast” on page 209 explains the basic URL 
format. 


+ Depending on the RealSystem Server logging parameters and the method 
it uses to broadcast the stream to RealPlayer viewers, broadcast statistics 
(such as the total number of viewers and how long each viewer watched) 
may be recorded in the server log files. 


Defining a Legacy Broadcast Server Destination 


This section explains how to define the legacy broadcast on RealProducer. You 
can create the server destination anytime before the broadcast, and can save 
the settings to a template for future use. You'll need the following information 
about RealSystem Server: 


- IP address or DNS name 
- listen port number 


- encoder log-in user name defined in the SecureEncoder realm of the 
authentication database 


- valid password for the user name 


> To set up a legacy server destination: 


1. If you have multiple jobs open, click the appropriate job file name in the 


job manager. 


. Select File>Add Server Destination to display the server destination dialog. 
Or, click the server icon in the destinations area. 


. Enter a description of the server in the Destination Name field. This is for 
your reference only and does not affect the broadcast. If you save the 
destination as a template, this entry becomes the name of the template in 


the graphical application, as well as the file name of the server destination 
file. 


. In the Stream Name field, enter a name for the broadcast stream. This 
name resembles a clip name and should use the appropriate extension, 
either .rm for a constant bit rate stream or .rmvb for a variable bit rate 
stream. This name appears in the broadcast URL. It can include uppercase 
or lowercase letters, numbers, an underscore (_), and a dash (-). Spaces are 
not allowed. 
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5. From the Broadcast Method pull-down list, select Legacy Push, (8.x, 7.x, 
G2), 


6. For Server Address, enter the IP address or DNS name of the RealSystem 
Server used for the broadcast, such as 207.188.7.176 or 


helixserver.example.com. 


7. The optional Path field specifies a virtual path that can be used for 
archiving or splitting on RealSystem Server. Use a simple name followed 
by a forward slash, such as news/. 


8. For Port, specify the listen port on RealSystem Server. This is typically 
4040. 


9. In the Username and Password fields, enter a valid encoder user name and 
password defined in RealSystem Server’s authentication database. The 
broadcast connection fails if either value is incorrect. If you are saving the 
destination as a template, you can click Remember password to store the 
user name and password in the job file or server template file. 


Warning! The password is saved as plain text in the job file or 
the server template. If you save the password, be sure that you 
maintain appropriate security on these files. 


10. Under Transport, click the radio button for UDP or TCP to select the 
protocol used with the broadcast stream. UDP is preferred, but may be 
blocked by firewalls. See “Broadcast Transport Protocols” on page 166 for 
descriptions of TCP and UDP. 


11. If you want to save the server destination as a template, click the 
Templates button and select Save as Template. You can then use this server 
destination for future broadcasts, as described in “Working with Server 
Templates” on page 207. 


12. Click OK to save the server destination. The destination appears in the 
destinations section of the RealProducer main window. You can right- 
click the destination name to edit or delete the destination. 


Starting and Stopping a Legacy Broadcast 


When you have completed the server destination and have defined the live 
input as described in “Using Live Audio or Video as the Input” on page 88, you 
can start the broadcast by clicking the Encode button. RealProducer 
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immediately begins to encode the live input, sending the broadcast stream to 
RealSystem Server. 


Because it maintains no monitoring connection with RealSystem Server, 
RealProducer receives no notice of a dropped stream. The legacy broadcast 
method does not automatically reconnect a dropped broadcast stream. If the 
stream is dropped, you must restart the encoding and broadcast process. You 
can terminate the broadcast from RealProducer by clicking the Stop button. 


Running a Pull Broadcast 


In pull broadcasting, RealProducer begins to generate broadcast packets as 
soon as you start the encoding. However, it does not deliver the broadcast 
stream until Helix Server requests the stream, which occurs when the first 
RealPlayer user requests the broadcast. Pull broadcasting thereby saves 
bandwidth between RealProducer and Helix Server when no one is viewing the 
broadcast. This broadcast method allows you to send a stream to Helix Server 


version 9 or later. 


For More Information: See “Running a Pull Broadcast” on page 
202 for set-up instructions. 


Advantages of Pull Broadcasting 


Pull broadcasting conserves bandwidth between RealProducer and Helix 
Server when a broadcast stream is not needed. This is useful in many cases, 
such as the following: 


* online radio stations 


You might use multiple instances of RealProducer to encode multiple 
streams for different online radio stations. Using pull broadcasting, you 
send to Helix Server only the streams for the stations that listeners have 
requested. 


+ server redundancy 


Helix Server can provide server redundancy by sending each RealPlayer a 
list of alternate servers to contact in case their connection to the primary 
server fails. If you use pull broadcasting, a backup server receives the 
broadcast stream only if a connection between a RealPlayer and a primary 
server is lost. 
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For More Information: See the chapter on multiple servers in 
Helix Server Administration Guide for more about redundancy 
servers. 


Disadvantages of Pull Broadcasting 


Because a pull broadcast does not begin until the first RealPlayer user requests 
the broadcast, the first viewer may experience a longer than normal delay as 
Helix Server contacts RealProducer to acquire the broadcast stream. After the 
server acquires the stream, however, the broadcast is queued on Helix Server 
and subsequent viewers experience no additional delay. 


When you use pull splitting, you do not have control over how many Helix 
Servers pull the stream. Any server that knows the RealProducer address, 
stream name, and access password can request the stream. You therefore have 
less control over your outgoing RealProducer bandwidth than you do with 
push splitting, in which you define exactly which servers receive the stream. 


Note: Each Helix Server that requests the broadcast receives a 
separate stream. Multicasting is not available with pull 
splitting. 


Pull Broadcast Steps 


The following figure illustrates the interaction between RealProducer, Helix 
Server, and RealPlayer in a pull broadcast. 


Pull Broadcasting 


Request Request 
of Ej 2. 
Bo lees owe eos eon Ph ane q 
>| > H 
1) ' 5 
RealProducer — Encoding Sent to Helix RealPlayer 
Begins Server Server 


(Not Yet Sent) 


1. RealProducer begins encoding live streaming media, but the output is not 
sent to Helix Server. 


2. The first audience member requests the broadcast, typically by clicking a 
link in a Web page. This launches RealPlayer, which requests the broadcast 
stream from Helix Server. 
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3. Helix Server requests the broadcast stream from RealProducer, sending it 
information about the server address and ports to use. Once the 
connection is established, Helix Server sends “keep alive” requests as long 
as viewers are receiving the broadcast. 


4. RealProducer sends the broadcast stream to Helix Server, terminating the 
stream when it receives no more keep alive messages. 


5. Helix Server streams the broadcast to RealPlayer users. 


Preparing Helix Server for Pull Broadcasting 


In a pull broadcast, RealProducer acts as a transmitter and Helix Server 
functions as a pull-enabled receiver in a splitting arrangement. This requires 
coordinated set-up on both ends. The chapter on transmitters and receivers in 
Helix Server Administration Guide explains splitting, and shows how to set up 
the server as a pull-enabled receiver. Before running a pull broadcast, confer 
with the server administrator on the following issues: 


- To be configured as a receiver, Helix Server must be licensed for broadcast 
distribution and pull-splitting. Clicking the About link in Helix 
Administrator displays the Helix Server licensing information. 


+ RealProducer requires that Helix Server transmit a valid password to pull 
the stream. This password is defined in the RealProducer server 
destination and the server receiver configuration. 


- The Helix Server receiver defines a range of ports it uses to receive the 
stream data. Default ports are 30001 to 30020. When the broadcast 
begins, RealProducer and Helix Server negotiate which ports to use. For 
best results, ensure that any firewalls between RealProducer and Helix 
Server allow UDP data sent to Helix Server on the ports in the defined 


range. 


- The Helix Server receiver definition specifies RealProducer as a 
transmitter source through its IP address, and indicates whether TCP or 
UDP is used. 


- In a pull broadcast, the Helix Server receiver defines the error correction 
parameters used for the broadcast stream. These parameters should be set 
in the pull-enabling section of the receiver configuration. 


+ If you want to archive or split the broadcast on Helix Server, you may need 
to apply archiving or splitting rules. This requires that the Helix Server 
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administrator define the rules for a specific virtual path that precedes the 
stream name, as in news/Live.rm. For background, refer to “Virtual Paths” 
on page 174. 


+ The URL for the broadcast varies depending on the Helix Server features, 
such as viewer authentication, that you use. The section “Standard URL 
for a Pull Broadcast” on page 210 explains the basic URL format. 


+ Depending on the Helix Server logging parameters and the method it uses 
to broadcast the stream to RealPlayer viewers, broadcast statistics (such as 
the total number of viewers and how long each viewer watched) may be 
recorded in the server log files. 


Defining a Pull Broadcast Server Destination 


This section explains how to define a password-only broadcast on 


RealProducer. You can create the server destination anytime before the 


broadcast, and can save the settings to a template for future use. 


> To 


ls 


define a pull server destination: 


If you have multiple jobs open, click the appropriate job file name in the 
job manager. 


. Select File>Add Server Destination to display the server destination dialog. 
Or, click the server icon in the destinations area. 


. Enter a description of the server in the Destination Name field. This is for 
your reference only and does not affect the broadcast. If you save the 
destination as a template, this entry becomes the name of the template in 


the graphical application, as well as the file name of the server destination 
file. 


. In the Stream Name field, enter a name for the broadcast stream. This 
name resembles a clip name and should use the appropriate extension, 
either .rm for a constant bit rate stream or .rmvb for a variable bit rate 
stream. The stream name can include uppercase or lowercase letters, 
numbers, an underscore (_), and a dash (-). Spaces are not allowed. 


. From the Broadcast Method pull-down list, select Pull (Helix Server). 


. For Local IP Address, select the IP address used by RealProducer to listen 
for pull requests. If your computer has just one IP address, that address is 
selected by default in the pull-down list. The Helix Server receive must 
specify this address as the transmitter address. 
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7. The optional Path field specifies a virtual path that can be used for 
archiving or splitting on Helix Server. Use a simple name followed by a 
forward slash, such as news/. 


8. For Producer Listening Port, indicate the port on RealProducer that it uses 


to listen for pull requests from Helix Server. By default, this port is 3031, 
but you can use any available port up to 65535. Firewalls should allow 
TCP communications through the chosen port. RealProducer and Helix 
Server then negotiate the ports to use for the data transfer. 


9. In the Password field, enter the password that the receiver must transmit 


to pull the broadcast. The broadcast connection fails if the receiver 
supplies the wrong value. If you are saving the destination as a template, 
you can click Remember password to store the password in the job file or 
server template file. 


Warning! The password is saved as plain text in the job file or 
the server template. If you save the password, be sure that you 
maintain appropriate security on these files. 


10. You may want to change the server timeout, which is the amount of time 


that RealProducer waits for a response from Helix Server before assuming 
that Helix Server has finished broadcasting. At this point, RealProducer 
shuts down the broadcast stream. It does not discontinue the broadcast 
stream, however. This allows other servers to pull the stream. 


The timeout value is 30 seconds by default. You can raise the value if 
previous pull broadcasts have timed out while RealPlayer viewers were still 
receiving the broadcast. RealNetworks does not recommend that you 
lower the value. Do the following to set the value: 


a. Click the Advanced Options button. 


b. In the Server connection timeout field, set a new value in seconds. 


c. Click OK. 


11. If you want to save the server destination as a template, click the 


Templates button and select Save as Template. You can then use this server 
destination for future broadcasts, as described in “Working with Server 
Templates” on page 207. 


12. Click OK to save the server destination. The destination appears in the 


destinations section of the RealProducer main window. You can right- 
click the destination name to edit or delete the destination. 
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Starting and Stopping a Pull Broadcast 


When you have completed the server destination and have defined the live 
input as described in “Using Live Audio or Video as the Input” on page 88, you 
can start the encoding process by clicking the Encode button. RealProducer 
begins to encode the live input, but does not send the broadcast stream to a 
Helix Server until the stream is requested. 


Helix Server typically re-requests a broadcast stream if it is inadvertently lost. 
During the broadcast, it periodically sends “keep alive” messages to 
RealProducer to indicate that it continues to need the stream. If the server 
notifies RealProducer that it no longer needs the stream, or the server 
connection times out, RealProducer stops transmitting the stream but does 
not stop the encoding process. This allows additional servers to pull the 
stream if necessary. You can terminate a broadcast stream and the encoding 
process by clicking the RealProducer Stop button. 


Working with Server Templates 


When you create a server destination, the server information is written to the 
job file if you save the job. Optionally, you can save the server definition as a 
separate server template. This allows you to share the server definition or add 
it quickly to any other broadcast job. RealProducer stores the server template 
as an XML-based text file in the servers directory under its main installation 
directory. Using RealProducer Plus, you can save any number of server 
templates. With RealProducer Basic, you can save one server template. 


For More Information: Appendix D explains how to edit a server 
file manually. 


Using a Server Template 


To save a server template, create a server destination as described in one of the 
broadcast set-up sections in this chapter. Then save the server definition as a 
template by clicking the Templates button and choosing Save as Template. To 
use that template in another job, select File>Add Server Destination, click 
Templates, and choose the template from the list. If you make changes to the 
template, you can change the destination name and save the changes as a new 
template by clicking Templates and choosing Add to List. 
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Editing or Deleting a Server Template 


You can edit any server template if you need to change it. These changes are 
recorded in the template and the active job, but not in any previous jobs that 
also used the server template. To update an older job, edit the job file 
manually. Or, open the job in the graphical application, and replace the server 
destination in the output with the revised server destination. 


Server Templates 


Template: Template name: Push to Sydney 


Push to Tokyo 
Broadcast method: Push, Password-Only Login (Helix Server) Y 


Internal Multicast 
Pull Radio Stations 


Broadcast Method Settings — - nee ——— 


Server address: sydney.example.com 
Path (Optional): | news/ 


Port/Port range: f30001 - |30020 —Transport, 
( UDP 

Producer listening port: Cc TCP 

Username: ey 

PERStislt [eco Iv Remember password 


\ Warning: Checking "Remember password" will result in saving the password 
in plain text in your job file and/or servertemplate. Sharing those files with 
other users will give those users access to your password-protected server. 


Advanced Options... 
Apply OK Cancel Help 


| al 


> To edit a server template: 
1. Select Edit>Server Templates to list all available templates. 


2. Select a template from the list. This displays the template’s settings in the 
right-hand side of the dialog. 


3. You can then perform any of the following actions: 


a. Edit the settings for the template as described in the various sections 
of this chapter. 


b. Click the “duplicate” icon at the bottom of the template list to copy 
the selected template. Then, edit the settings fields. This allows you to 
create a similar template quickly. 


c. Click the trash icon to delete the selected template. 


4. Click Apply to save changes to the template. Click OK to exit the dialog 
and save any changes. 
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Broadcast URLs 


The following sections provide a general guide to URLs used by RealPlayer 
viewers to play a broadcast. Confer with the Helix Server administrator about 
the actual URL to use, as URLs can vary from the standard forms described 


below for many reasons: 


- An HTTP URL in a Web page includes a /ramgen/ mount point, whereas 
an RTSP URL in a Ram or SMIL file does not. 


- The Helix Server administrator can change the mount point (typically 
/broadcast/, /encoder/, or /redundant/) used with any broadcast method. 


- Using the splitting feature, the Helix Server administrator can route the 
broadcast stream to multiple receivers. This lengthens the broadcast URL, 
and the URL to the stream on each receiver will differ. 


- Including features such as user name and password authentication for 


viewers adds additional mount points to the URL. 


- The Helix Server administrator may shorten long broadcast URLs by 
substituting an alias for parts of the URL. 


Standard URL for a Push Broadcast 
For a basic push broadcast that the viewer accesses by clicking a link in a Web 
page, the URL looks like the following: 
http://helixserver.example.com/ramgen/broadcast/news/live.rm 
+ The /ramgen/ mount point launches RealPlayer when the viewer clicks the 
link in a Web page. If the URL is in a Ram file (.ram or .rpm) or SMIL file 


(.smil), the /ramgen/ mount point is omitted and the protocol is rtsp://. 


- The /broadcast/ mount point is the default mount point used by Helix 
Server for an account-based or password-only broadcast. For legacy 
broadcasts, the mount point is /encoder/. If redundant encoders are used 
with any broadcast method, the mount point is /redundant/. 


- A virtual path such as news/ is optional. It is included in the URL only if 
RealProducer specifies this path along with the stream name. 


- You define the stream name, shown as live.rm above, through the 
RealProducer server destination. 
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Note: If you use encoder redundancy, RealProducer defines 
delimiters in the stream name, such as .1 and .2. These 
delimiters are not included in the URL. 


Standard URL for a Pull Broadcast 


The URL to a pull broadcast is longer than a URL to a push broadcast because 
it includes information about both the Helix Server receiver and the 
RealProducer transmitter. The following example shows the general format 
for a basic pull broadcast that the viewer accesses by clicking a link in a Web 
page. For convenience, the example is displayed on two lines. The first line 
gives the receiver information. The second line supplies the transmitter 
parameters: 


http://receiver.example.com/ramgen/broadcast/pull/ 
realproducer.example.com:3031/news/live.rm 


- The /ramgen/ mount point launches RealPlayer when the viewer clicks the 
link in a Web page. If the URL is in a Ram file (.ram or .rpm) or SMIL file 
(.smil), the /ramgen/ mount point is omitted and the protocol is rtsp://. 


- The /broadcast/ mount point is the default mount point used by Helix 
Server for a pull broadcast. Following the broadcast mount point is a path 
that indicates pull splitting is used, as in /pull/. The Helix Server receiver 
defines this path. 


+ The link’s transmitter portion lists the RealProducer IP address or host 
name, along with its listen port, as in realproducer.example.com:3031. 


- A virtual path such as news/ is optional. It is included in the URL only if 
RealProducer specifies this path along with the stream name. 


- You define the stream name, shown as live.rm above, through the 
RealProducer server destination. 


PART 


IV 


MEDIA TOOLS 


In addition to the RealProducer grapical application, you can 
use the command-line application, media editor, and event 


encoding tool described in the next set of chapters. 


CHAPTER 


AZ 


EDITING REALMEDIA FILES 


RealMedia Editor allows you edit RealAudio and RealVideo clips. 
You can shorten a clip, for example, but cutting it at its beginning or 
end. You can change the title, author, and other clip information. 
You can also can merge image maps or interactive events into a 
RealMedia file. You can use a command-line editor on Windows and 


Linux, and a graphical editor on Windows. 


Note: RealMedia Editor is included with RealProducer Plus, 
but not with RealProducer Basic. 


Using the Graphical Editor 


RealMedia Editor is installed automatically in the RealMediaEditor directory 
under the main RealProducer installation directory. On Windows, you can use 
the rmeditgui graphical editor program. To open the graphical editor, give the 
File>Edit RealMedia File command on RealProducer. The menu items at the 
top of the window allow you to access different functions of the editor: 


- Use File to open, save or append to a RealMedia clip. 
- Use Navigate to jump to key frames and edit points. 


- Use Tools to access clip and stream information, merge image maps and 
events, and edit your preferences. 


+ Use Help to locate information about running the editor. 
The editor also has these functional areas: 
- The clip viewer is a video window that shows the video portion of the clip. 


- The timeline provides a graphical representation of the input file. You can 
move the slider to any keyframe or edit point. The current time position is 
also shown here. 


¢ The zoom tool zooms in or out of the timeline. 
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- The clip info area allows you to change the title, author, copyright, 
keywords, and description of a clip. You can also view the clip’s stream 
information this area. 


Opening a RealMedia Clip 


Once you have opened a RealMedia clip, you can play it, navigate through it, 
and edit it. 


> To open a clip: 
1. In the main window, choose File>Open RealMedia File. 


2. Navigate to the directory where the RealMedia file (extension .rm or .rmvb) 
is located and select it. You can edit RealMedia clips that are under 2 
Gigabytes in file size. 


3. Click Open to display the clip in the main window. If it is a RealVideo clip, 
the first frame appears in the viewer. 


Tip: You can also drag a clip into the RealMedia Editor main 
window to open that clip instantly. 


Navigating Through a Clip 


RealMedia Editor gives you different methods to navigate through a clip to 
find the points to edit. You can use the slider on the timeline, click the Play 
and Stop buttons, use edit points, or use keyframes. 


Using the Timeline 


Using the timeline is the easiest way to navigate along your clip. The red line 
marks the current position in the clip. To move the line, either click on it and 
drag it to a new position, or click with the mouse button at a desired point in 
the timeline. This displays the video frame at that point. 


Using Buttons 


Using the navigation buttons is another way to find part of a clip. Click the 
Play button to start playback. Click Stop when you reach the desired point in 
the clip. 
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Using Keyframes for Video Clips 


Keyframes are video frames that are encoded pixel-for-pixel. A RealVideo clip 
consists of a number of keyframes. The frames between keyframes are based 
on the keyframes, and a video clip must have at least one keyframe. Navigating 
with keyframes allows you to jump to a main section of a clip, such as the start 
of a new scene. Click the >> button to go to the next keyframe in the clip. 
Click << to go to the previous keyframe. 


Using Edit Points for Audio Clips 


Edit points are possible points at which you can edit a clip. These points are 
designated by the smallest block of audio data that a clip can be split into. 
There are no edit points in a video-only clip, so you can edit the clip at any 
point. Click the > button to go to the next edit point in the clip. Click the < 
button to go to the previous edit point in the clip. 


Editing with the RealMedia Editor 


This section shows you how use the RealMedia Editor to edit a RealMedia clip. 
You will learn how to edit out the beginning or end of a clip, how to change 
clip information, how to merge either an image map or an interactive event to 
a clip, and how to append another clip to the current clip. 


Editing a Clip’s Beginning or End 


Using RealMedia Editor, you can remove portions from the beginning or end 
of a clip. This section shows you how to mark the points for editing, and gives 
you tips on editing a clip. 


> To edit the beginning or end of a clip: 


1. Open the clip and navigate to the point that will be the clip’s new 
beginning. 


2. Click the In button. On the timeline, the beginning of this section is 
marked by a bracket ([ ). The following parts on the timeline display in a 
darker grey color. 


Tip: You can also modify the beginning of your clip by 
changing the current time within the In field. 


3. Navigate to the point that will be the end of the new clip. 
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4. Click the Out button. On the timeline, the end of the clip is marked by a 
bracket (] ). The portion of the timeline between the two brackets shows 
in a darker grey color. The new ending time of the clip is also shown. 


Note: You can modify the end of your clip by changing the 
current time within the Out field. 


5. Click Play Selection to play the marked section of the clip and verify that 
you have selected the appropriate parts. 


Note: You cannot change the beginning and end marks until 
the clip has stopped playing. 


6. When you are satisfied with the new clip, select File>Save RealMedia File As 
and choose a new name for the edited clip. 


Editing Tips 
The following tips will help edit clips: 


- If you set a selection point between keyframes, the cutting may not be 
precisely accurate. The resulting video may have a black or frozen image, 
or it may simply begin at the next keyframe. 


- A video clip must contain at least one keyframe. If you create a clip 
without a keyframe, you will be unable to save it. 


- You can type time values directly for current clip position using the 
format days:hours:minutes:seconds.milliseconds. 


Changing Clip Information 


Clip information tells the audience about a clip and allows the audience to 
find a clip more easily. With RealMedia Editor, you can add clip information if 
none exists or you can change clip information that is attached to a file. 


> To change clip information: 


1. Open a RealMedia file. 
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2. In the Clip Info area, enter new information for the clip: 


Title In this field, enter the title of the clip or broadcast. Because this 
title appears in the RealPlayer interface, it is best to use a short 
title. 

Author This field holds the name of the person or organization that 


created the clip. 


Copyright Here, enter the copyright string, such as (c) 2004 ABC 
Corporation. 


Keywords The keywords field holds words that certain audio and video 
search engines can read to categorize the clip. Add a few words 
that will help your audience search for your clip. Separate each 
term with spaces. Unless you are adding a proper name, use 
lowercase for each term. Avoid overly generic terms such as video 
or music. 


Description This field holds a description of the clip that appears when the 
viewer displays extended clip information. This allows you to 
describe the clip in detail without creating a long title. 


3. To enter rating information, click the Clip Info button. In the dialog, you 
can enter any clip information described previously, and also set a rating: 


» No Rating 
- All Ages 
+ Older Children 
+ Younger Teens 
+ Older Teens (15 and up) 
- Adult Supervision Recommended 
- Adults Only 
4. Click OK to return to the main window. 


5. To save the new clip, select File>Save RealMedia File As and save the clip 


under a new file name. 


Merging Image Maps or Events 


Image maps are text files that create clickable fields within a RealVideo clip. 
When clicked by a viewer, the image map causes a specific action, such as 
opening a Web page in the viewer’s browser. Events are similar to image maps, 
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except that actions happen automatically without audience interaction. Using 
RealMedia Editor, you can merge these files into a RealMedia clip. 


For More Information: Chapter 13 explains how to write an 
image or event file. 
> To merge an image or event file into a RealMedia clip: 
1. Open the RealMedia clip. 
2. Select Tools>Merge Image Maps or Tools>Merge Events. This opens a file 
dialog. 


3. Locate the image map or event file that you want to merge and click Open. 
RealMedia Editor merges the file information with the clip, creating a 
new, untitled clip and closing the original clip. 


4. To save the new clip, select File>Save RealMedia File As and save the clip 
under a new file name. 


Appending Clips 


RealMedia Editor allows you to combine one RealMedia clip with another. 
Appending works only when the number and type of streams in each file are 
identical. Therefore, this feature works best when the source files are all 
encoded with RealProducer using the same settings. 


Note: The total size of the appended clips cannot exceed the 


editor’s 2 Gigabyte file size limit. 


> To append one clip to another: 
1. Open the first RealMedia clip. 
2. Select File>Append RealMedia File. 


3. Locate the clip you want to append and click Open. RealMedia Editor the 
appends the selected clip to the open clip. This process can take some 
time, depending on the size of the second clip. 


4. When the appending process completes, you can edit the combined files 
and save it as a new clip. The editor closed the original clips. 
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Using Advanced Editing Features 


RealMedia Editor provides advanced features that can help you with the 
editing process. You can view information about all streams within a clip. Plus, 
you can decide how fast RealMedia Editor previews a clip. 


Viewing Stream Information 


Every RealMedia clip contains a number of streams. Single rate VBR files 
contain only one stream, whereas SureStream CBR files can contain multiple 
streams depending on the number of target audiences. RealMedia Editor 
allows you to view information about each encoded stream. However, if your 
file does not contain any recording information, the corresponding field will 
be blank. 


> To view stream information: 


1. Open a RealMedia file. 


2. Select Tools>Stream Info. This opens a dialog that provides the following 
information: 


+ Audio Mode—the type of audio for the encoded clip (such as music or 
voice) 


+ Video Mode—the quality of the encoded video (such as normal or 
smooth motion) 


+ Video Size—the size and width, in pixels, of the encoded video 
- File Type—either single rate or SureStream 


- Audiences--the audience bandwidth you have selected. 


This dialog also gives you the following information about each stream 
within the clip: 


+ Bit Rate—the amount of bandwidth necessary to view the stream 


¢ Preroll—the amount of bits needed to download before the stream 
can play 


+ Frequency—the frequency response of the encoded audio for the 
stream 


+ Codec—the compression/decompression algorithm used to encode 
the stream. 


3. Click Close to return to the main window. 
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Changing Editor Preferences 


RealMedia Editor allows you to change how it previews a clip you open. You 
view a clip quickly, or more accurately. The accurate view takes more time to 
render if the clip is large. 


» To change RealProducer preferences: 
1. Select Tools>Preferences to open the preferences dialog. 
2. Select a method for opening clips: 


* Quick—Plays back the selection without delay. However, audio and 
video may not play exactly as they do in the saved clip. For example, 
frames of video at the beginning of a clip may appear different. And 
audio may not stop precisely at the end of a clip. 


- Accurate—saves the selection to a temporary file. This can take a 
significant time for long clip. The preview, however, will look and 
sound exactly like the saved clip. 


3. Click OK to return to the main window. 


Running the Command Line Editor 


The rmeditor executable program in the RealMediaEditor directory runs 
RealMedia Editor from the command line on Windows and Linux. There are 
three main functions that this program performs: 


+ It extracts information about a RealMedia clip (also called a “dump”). 


+ It changes metadata, such as title, author, keywords, and copyright 
information in a clip. 


+ It cuts clips and can paste clips together. 


The following table summarizes the rmeditor options, which have both long 
and short option flags. 


RealMedia Command-Line Editor Options 


Flag (long and short) Value Function 

-input -j filename.ext Indicates path to the input file. 
-output -o | filename.rm Specifies path to the output file. 
-title ale text Gives the title text. 

-author -a text Specifies the author name. 


(Table Page 1 of 2) 
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RealMedia Command-Line Editor Options (continued) 


Flag (long and short) Value Function 
-copyright -C text Provides the copyright text. 
-comment -C text Any comments about the clip. 
-startTime -s | dd:hh:mm:ss.xyz_ | Sets clip start time. 
-endTime -e dd:hh:mm:ss.xyz_ | Sets clip end time. 
-logFile -l filename.log Gives path to the log file. 
-dumpFile -d =| filename.txt Sets the path to the dump file. 
-description |-q text Describes the file contents. 
-keywords -n text Provides a list of keywords. 
-rating -R O=No rating Allows you to rate the content. 

1=All ages 

2=Older children 

3=Younger teens 

4=Older teens 

S=Adult 

supervision 

recommended 

6=Adults only 


(Table Page 2 of 2) 


Getting Information from a RealMedia Clip 


Use the following syntax to create a text-based dump file that contains 
information about an encoded RealMedia clip: 


rmeditor -inputFile filename.rm -dumpFile filename.txt 


Editing Metadata 


The following syntax shows how to edit clip information: 


rmeditor {-inputFile <filename>} {-outputFile <filename>} 
[-t | -title <title>] [-a | -author <author>] [-c | -copyright <copyright>] 
[-q | -description <description>] [-n | -keyword <keywords>] [-r | -rating 


<rating> 
Cutting and Pasting Files 


Use the following syntax to cut files and paste two files together: 


rmeditor {-i | -input | -inputFile <input> [-s | -startTime <dd:hh:mm:ss.xyz>] [-e | 
-endTime <dd:hh:mm:ss.xyz>] } 
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[-i | -input | -inputFile <input> [-s | -startTime <dd:hh:mm:ss.xyz>] [-e | - 
endTime <dd:hh:mm:ss.xyz>] ] 


{-o | -output | -outputFile <filename>} 
[-t | -title <title>] [-a | -author <author>] [-c | -copyright <copyright>] 
[-q | -description <description>] [-n | -keyword <keywords>] 


Common RealMedia Editor Command Line Operations 
The following are frequently used operations. 


- View the current title, author, copyright, comments, mobile playback and 
selective record setting: 


meditor -i input.rm 


Change the current title of a .rm file: 


rmeditor -i input.rm -t "new title text" -o output.rm 


Enable the allow recording flag: 


rmeditor -i input.rm -r 1 -o output.rm 


Disable the allow recording flag: 
rmeditor -i input.rm -r 0 -o output.rm 
+ Trim the duration of a file: 
rmeditor -i input.rm -s 0:0:3:2.20 -e 0:0:4:2.20 -o output.rm 
Note: The start and end times will be adjusted so the clip starts 


and ends on keyframe boundaries. Use 0 as the end time to 
specify the end of the file. 


Paste multiple RealMedia files together: 
rmeditor -i input.rm -i input2.rm -i input3.rm -o output.rm 


Note: If more than one input file is specified, any start and end 
time arguments are ignored. 


- Add a description to the file: 


rmeditor -i input.rm -q "This file contains audio and video of the 1/1/99 
meeting" -o output.rm 


- Add keywords to the file: 


rmeditor -i input.rm -n "travel Fiji resorts" -o output.rm 
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+ Enable the allowing indexing flag: 


rmeditor -i input.rm -IN 1 -o output.rm 
+ Disable the allowing indexing flag: 


rmeditor -i input.rm -IN 1 -o output.rm 
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DEFINING EVENTS AND IMAGE MAPS 


When you produce RealAudio or RealVideo clips using 
RealProducer, you can use a utility that embeds clip information 
and HTML URLs directly in the clip. For RealVideo clips, you can 
also create clickable image maps. This chapter explains how to write 
markup that creates these features, and how to run the utility that 


merges the markup with the encoded clips. 


Understanding Events and Maps 


Event files and map files are text files that use a simple markup language. An 
event file defines URLs that open automatically in a the viewer’s browser as 
the audio or video clip plays. This allows you to create a presentation in which 
HTML pages are timed to display at certain points as the clip plays. The events 
file can also encode extended clip information beyond the standard title, 
author, and copyright. 


The map file can define image maps that overlay a RealVideo clip and open 
when the viewer clicks a predefined hot spot. These hot spots can be the entire 
video, or a smaller area in the shape of a circle, rectangle, or irregular polygon. 
So whereas the event file URLs open automatically, the map file URLs open 
only on user interaction. 


Once you define your event file or map file, you merge the file with your 
encoded clip using the RMEvents utility. This creates a copy of your clip that 
has the event or map information permanently encoded into it. To change the 
events or maps, you must create a new version of the clip by merging the 
original clip with a new event file or map file. 


Tip: Using a map file or event file is just one way to open URLs 
and add extended clip information. Ram files and SMIL files 
also provide these capabilities. Because these latter techniques 
do not encode information directly into the clip, they allow 
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you to change the information more readily. For a comparison 
of all available production techniques, refer to the first chapter 
of Introduction to Streaming Media. 


Writing an Events File 


The events file is a plain text file that uses the standard extension of .txt. 
Within this file, you describe events that will occur as the clip plays. You write 
each event on a separate line, and you can use a pound sign (#) to start a 
comment line. Each event line follows this format: 


flag start_time end_time event_syntax 


The flag indicates the type of event, which can be either to display clip 
information, or to open a URL in an HTML pane automatically. The following 
table summarizes the possible flags. 


Events File Flags 


Flag Action Reference 
a Add author information to the clip. page 228 
c Include copyright information in the clip. page 228 
i Add title information or include extended clip information. page 228 

page 229 
u Open a URL automatically as the clip plays. page 226 


The starting time and ending time are relative to the start of clip playback. 
You indicate the time value with the following format, in which only the 
seconds field is required: 


dd:hh:mmi:ss.xyz 


After you create your event file, you encode it into the clip as described in 
“Running the RMEvents Utility” on page 238. 


Note: Define each event on a single line within the events text 
file. Do not press Enter to wrap long lines manually. 


Specifying URL Events 


When opening a URL automatically in an HTML pane, you use the u event 
flag. The event syntax looks like this: 


u start_time end_time &&target&&URL?parameters 
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Browser Target 


The URL must be a fully qualified HTTP URL. For target, you specify one of 
the HTML panes found in RealOne Player through RealPlayer 10. Earlier 
versions of RealPlayer, which do not handle HTML pages natively, display the 
URL in the viewer’s default browser. If you plan to embed the clip in a Web 
page, you can specify an HTML frame name. You can use one of the following 
values. 


frame_name Display the URL in the designated browser frame. 
_rpcontextwin Display the URL in the RealPlayer related info pane. 
_tpbrowser Display the URL in the RealPlayer media browser pane. 


_rpexternal Display the URL in a secondary RealPlayer browsing window. 


For More Information: If you are unfamiliar with the RealPlayer 
HTML windows, refer to the first chapter of Introduction to 
Streaming Media.For information about playing a clip in a Web 
page, refer to the web page embedding chapter of RealNetworks 
Production Guide. 


Related Info Pane Sizing 


If you use _rpcontextwin to open the URL in the related info pane, you can use 
either of the following parameters to set the size of the pane: 


rpcontextheight=pixels Sets the pixel height of the related info pane. If no height is 
specified, RealPlayer uses the height of the media clip. 


rpcontextwidth=pixels — Sets the pixel width of the related info pane. If no width is 
specified, a default of 330 pixels is used. 


Events File URL Examples 


The following is a sample events file that opens two URLs in the related info 
pane at different times, and two URLs in the media browser pane at different 
times: 


# Open a URL in the related info pane when the clip starts, and size the pane. 
u 00:00:00.0 00:01:59.9 && _rpcontextwin&& 
http://www.example.com/info1.html?rpcontextheight=250&rpcontextwidth=280 
# 

# Open a URL in the media browser pane at the 1-minute mark. 

u 00:01:00.0 00:01:59.9 && _rpbrowser&&http://www.example.com/index.html 
# 

# Open a second URL in the related info pane at the 2-minute mark. 


227 


RealProducer 10 User’s Guide 


228 


u 00:02:00.0 00:04:00.0 && _rpcontextwin&&http://www.example.com/info2.html 
# 

# Open a second URL in the media browser pane at the 3-minute mark. 

u 00:03:00.0 00:04:00.0 && _rpbrowser&&http://www.example.com/index2.html 


Note the following about this sample: 


- When you open multiple URLs, list the events in ascending order 
according to the start times. 


- The related info pane size is set for the duration of the clip by the first 
URL that opens in that pane. Any subsequent URLs that target the related 
info pane therefore do not require sizing information. 


+ The end times indicate a point past which the URL should not open. In 
the second event defined above, the URL is scheduled to open at 1:00 
minutes, but no later than 1:59.9 minutes. If a viewer starts the clip and 
immediately seeks to its 3-minute mark, for example, the URL doesn’t 
display because the clip never plays at any point between the URL’s start 
and end times. 


Adding a Title, Author, and Copyright 


When you encode a clip, you have the option of including clip information 
values as described in “Adding Clip Information” on page 92. Using the events 
file, you can override the existing title, author, and copyright values, or add 
them if you did not include them during the encoding process. The events file 
does not allow you to add other values such as keywords and a description, 
however. 


To add the title, author, or copyright, you include the i, a, or c event flag in the 
events file, respectively. The format is the same for specifying URLs: 


flag start_time end_time value 


Values do not need to be quoted. The following are examples: 
1 00:00:00.0 00:00:10.0 2004 Music Awards 


a 00:00:00.0 00:00:10.0 Brilliant Media Limited 
c 00:00:00.0 00:00:10.0 2004 Brilliant Media Limited 


For clip information flags, you can specify the start time as the clip’s starting 
time (00:00:00.0). Specifying an end time is required, but the actual end time 
doesn’t matter because the clip information will display throughout the 
length of the clip playback. In the example above, the end times are set to 10 
seconds after the clip starts. 
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Adding Extended Clip Information 


Using an events file, you can also encode several clipinfo parameters. Geared 
for online music, these parameters allow you to add information such as the 
artist name, album, genre, and so on, which displays when the viewer chooses 
the File>Clip Properties>View Clip Info command, or presses Ctrl+i. This 
information displays in RealOne Player or later, and is ignored by earlier 
RealPlayers. It can include the title, author, and copyright, so you do not need 
to include those separately, as described in “Adding a Title, Author, and 
Copyright” on page 228. 

The clipinfo parameter uses the i event flag and one long value surrounded by 
double quotation marks. Within the quotes, you separate the subvalues with 
vertical lines, or “pipes,” as shown here: 


i 00:00:00.0 00:00:10.0 clipinfo:title=My Presentation|artist name=Pat Morales|... 


For clip information, you can specify the start time as the clip’s starting time 
(00:00:00.0). Specifying an end time is required, but the actual end time 
doesn’t matter because the clip information will display throughout the 
length of the clip playback. In the example above, the end time is set to 10 
seconds after the clip starts. 


Clip Information Parameters 


The following table describes the name and value pairs that you can use with 
clipinfo. You can use any set of values, and list them in any order. Most text 
values can be over 100 characters long. 


clipinfo Parameter Values 


Name and Value Function 

title=text Gives the clip title. 

artist name=text Indicates the artist name. 

album name=text Gives the album name. If you specify an album name and do 


not also display an HTML page in the related info pane, 
RealPlayer displays in that pane a standard page that lists the 
artist, album, year, and genre values. The viewer can hide this 
information, though, with View>Album Info>Hide. 


genre=text Indicates the clip genre, such as Rock or Jazz. 
copyright=text Gives the copyright notice. 
year=text Indicates the year the content was released. 


(Table Page 1 of 2) 
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clipinfo Parameter Values (continued) 


Name and Value Function 


cdnum=number Supplies the CD track number. 
comments=text Provides any additional comments. 


(Table Page 2 of 2) 


Text Escape Characters 


To use certain text characters in a value for the clipinfo parameter, you must 
use the character’s corresponding escape code. This is because certain 
characters represent syntax components. A pipe (|) represents the start of a 
new value, for example, so to use a pipe within a value, you must use the 
escape code %7C. The following table lists some common text characters that 
you can add through escape codes. 


Text Character Escape Codes 


Name Character Escape Code 
ampersand & % 26 
apostrophe ; % 27 
backslash \ %5C 
carat ‘ %5E 
double quote ; 22 
greater than sign > %3E 
left bracket [ %5B 
less than sign < %3C 
percent sign %o 25 
pipe | %7C 
pound sign # 23 
right bracket ] %5D 


You can enter other common text characters, such as commas, periods, and 
colons directly into clipinfo parameter. Conversely, you can display any text 
character, including letters and numbers, by using an escape code that starts 
with % followed by the character’s ASCII hexadecimal value. You can create an 
asterisk (*) with the escape code %2A, for example. 


For More Information: Visit http://www.asciitable.com for a 
full list of ASCII codes. 
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Clip Information Example 
This example sets the clipinfo parameter for an audio clip: 


1 00:00:00.0 00:00:10.0 clipinfo:title=Artist of the Year| 
artist name=Your Name Herel|album name=My Debut|genre=Rock| 
copyright=2001|year=2001|comments=This one really knows how to rock! 


The following figure illustrates how this information appears in the clip 
information panel (Ctrl+i). 


Clip Information 


p File Credits 


Title: Artist of the Year 


Artist: ‘Your Name Here 

Album: My Debut 

Genre: Rock 

Copyright: ©2001 RealNetworks, Inc 

Length: 0:10 Year: 2001 CD Track &% 
Comments: This one really knows how to rack! 


Creating Image Maps 


For a RealVideo clip, you can write a map file to create image maps that open 
a URL or issue a RealPlayer command when clicked. The image map can 
provide one or more clickable hot spots that are active for the entire duration 
of the clip, or only during certain periods. You can create these hot spots in 
the shapes of rectangles, circles, or polygons. Clicking the left half of a video 
might take the viewer to one Web page, for example, while clicking the right 
half opens a different page. 


You can create a map file using any text editor that can save output as plain 
text. The map file uses a simple markup similar to HTML that defines the hot 
spot locations, durations, and actions. Once you define your map file, you 
merge the map coordinates into the RealVideo clip using the RMevents utility, 
as described in “Running the RMEvents Utility” on page 238. 


Tip: You can also use SMIL to create clickable image maps that 
overlay a video or multiclip presentation. The advantage to 
using SMIL is that the map coordinates are not merged into 
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the clip, and are therefore easier to change. However, you must 
always stream the clip through the SMIL file to make the hot 
spots available. For more information, see the hyperlinking 
chapter of RealNetworks Production Guide. 


Setting a Duration 


The map file begins with a mandatory DURATION parameter that defines the 
total amount of time that the hot spots are active, using a time value in the 
following format: 


dd:hh:mm:ss:xxx 
In this time format, you must specify all fields. The last field, which indicates 
milliseconds, is separated from the seconds field by a colon, not a period as in 


other time formats. The following example sets the entire duration of the hot 
spots to five minutes, 30 seconds: 


DURATION=0:0:5:30:0 


Creating the Overall Map 


Following the DURATION parameter, you define the overall area that can 
contain a hot spot between <MAP> and </MAP> tags. The <MAP> tag uses START 
and END parameters that define when the map area is active, relative to the 
start of clip playback. Like DURATION, the START and END parameters have 
values in the following format: 


dd:hh:mm:ss:xxx 


The following map area becomes active 30 seconds after the start of the clip, 
and stays active for one minute: 


<MAP START=0:0:0:30:0 END=0:0:1:30:0 ...>...</MAP> 


The COORDS parameter, which must follow the START and END parameters, 
defines a rectangle for the map. It uses four values, separated by commas, that 
set the map’s size and placement, measured from the upper-left corner of the 
clip in the following order: 


1. distance of the map’s left edge from the clip’s left edge (left-x) 
2. distance of the map’s top edge from the clip’s top edge (top-y) 
3. distance of the map’s right edge from the clip’s left edge (right-x) 


4. distance of the map’s bottom edge from the clip’s top edge (bottom-y) 
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The COORDS parameters allows you to create a map area from any rectangular 
portion of the clip area. The simplest way to define the map is to create it at 
the same size as the clip. If the clip is 360 pixels wide by 240 pixels high, for 
example, you use a map tag such as the following: 


<MAP START=0:0:0:30:0 END=0:0:1:30:0 COORDS=0,0,360,240>...</MAP> 


Tip: You can define more than one map area. Typically, each 
map area is active at a different point during the clip timeline. 
If map areas are active at the same time, the map areas or the 
hot spots that each map defines should not overlap. 


Defining Hot Spot Areas 


To create a hot spot, you use an <AREA> tag with a SHAPE attribute that defines 
the hot spot’s shape, and a COORDS attribute to define the hot spot’s size and 
placement. You define the SHAPE and COORDS attributes just as you do in 
HTML 4.0. The following example defines a rectangular hot spot: 


<AREA SHAPE=RECTANGLE COORDS=20,40,80,120 ...> 
How you specify the coordinate values depends on what shape—rectangle, 
circle, or polygon—you want, as explained in the following sections. In all hot 


spots, the coordinates are measured from the upper-left corner of the area 
defined by the <MAP> tag. 


Creating a Rectangular Hot Spot 


Use SHAPE=RECTANGLE to create a rectangular hot spot. You then specify four 
COORDS pixel values to set the hot spot’s size and placement, measured from 
the upper-left corner of the map in the following order: 


1. distance of the hot spot rectangle’s left edge from the map’s left edge 
(left-x) 


2. distance of the hot spot rectangle’s top edge from the map’s top edge 
(top-y) 

3. distance of the hot spot rectangle’s right edge from the map’s left edge 
(right-x) 

4. distance of the hot spot rectangle’s bottom edge from the map’s top edge 
(bottom-y) 


Coordinate values are separated by commas, as shown in the following 
example: 
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<AREA SHAPE=RECTANGLE COORDS=20,40,80,120 ...> 


The preceding example defines a hot spot 60 pixels wide (80 pixels minus 20 
pixels) and 80 pixels high (120 pixels minus 40 pixels). It creates a hot spot like 
that shown in the following illustration. 


Rectangular Hot Spot 


40 


20 


120 


Tip: Think of the first pair of values as defining the x and y 
coordinates of the hot spot’s upper-left corner, and the second 
pair of values as defining the x and y coordinates of the hot 
spot’s lower-right corner. 


Defining a Circular Hot Spot 


You can use SHAPE=CIRCLE to create a circular hot spot. Three COORDS pixel 
values specify the circle’s center placement and radius in the following order: 


1. distance of the hot spot circle’s center from map’s left edge (center-x) 
2. distance of the hot spot circle’s center from the map’s top edge (center-y) 
3. the hot spot circle’s radius 


The coordinate values are separated by commas, as shown in the following 
example: 


<AREA SHAPE=CIRCLE COORDS=100,120,50 ...> 


The preceding example places the circular hot spot’s center 100 pixels in from 
the clip’s left edge, and 120 pixels down from the clip’s top edge. The hot spot 
has a radius of 50 pixels. The following figure illustrates this example. 


234 


CHAPTER 13: Defining Events and Image Maps 


Circular Hot Spot 


120 


PRL 


Tip: The last value, which sets the circle’s radius, should not be 
more than the smaller of the other two values. If the first two 
values are 40 and 20, for example, the third value should not be 
more than 20. Otherwise, part of the circle extends beyond the 
clip boundaries and is cut off. 


Making a Polygonal Hot Spot 


Use SHAPE=POLYGON to make a polygonal hot spot with any number of sides. 
You might create a triangle or an octagon, for example. For every n sides of the 
polygon you want to create, you must specify 2n values in the COORDS attribute. 
To create a triangle, for example, you need to specify six COORDS values. Each 
pair of coordinate values indicates the placement of a corner of the polygon in 
this order: 


1. distance of the polygon corner from the map’s left edge (corner-x) 


2. distance of the polygon corner from the map’s top edge (corner-y) 
The following example defines a triangular hot spot: 
<AREA SHAPE=POLYGON COORDS=40,150,120,30,200,150 ...> 
The following figure illustrates the preceding example. The first value pair for 
the COORDS attribute defines the triangle’s lower-left corner. The COORDS value 


pairs then proceed clockwise, defining the top corner, followed by the lower- 
right corner. 
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Polygonal Hot Spot 


150 150 


40 


Tip: When defining a polygon, you can start with any corner, 
specifying the placement of additional corners by going 
around the polygon either clockwise or counter-clockwise. 


Tips for Defining Hot Spots 


- A viewer may resize a presentation manually by, for example, clicking and 
dragging a RealPlayer corner. In these cases, hot spots scale with clips. 


- Values such as COORDS=30,30,10,10 for a rectangular hot spot are ignored, 
and the hot spot will not function. Here, the hot spot’s left side is defined 
as being farther to the right than its right side. As well, the top is defined 
to be below the bottom. 


A hot spot defined to extend beyond the source clip is cropped at the clip’s 
edge. For example, ifa rectangular hot spot uses COORDS=50,50,300,300 but 
the source clip is 200 by 200 pixels, the hot spot’s effective coordinates are 
50,50,200,200. 


If multiple hot spots overlap on a clip, the link for the hot spot defined 
first in the file is used when the viewer clicks the overlapping area. 


Many programs, including shareware and freeware, can generate HTML 
image maps. You can use one of these programs to define the coordinates 
for a hot spot. Simply create an HTML image map over an image that is 
the same size as your clip, view the HTML source, and copy the image map 
coordinates into your <AREA> tag. 
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Setting the Action 


The <AREA> tag for a hot spot can define one of three actions that occur when 
the viewer clicks the hot spot. The action parameter should follow the COORDS 
parameter in the <AREA> tag: 


PLAYER Play a different clip. The URL should be a quoted, fully-qualified streaming 
media URL. 


SEEK Seek to a different part of the timeline. The time value uses the same format 
as the DURATION element, as described in “Setting a Duration” on page 232. 

URL Open the HTML page in the viewer’s browser. The value should be a quoted, 
fully-qualified HTTP URL. In RealOne Player and later, this URL opens ina 
secondary browsing window rather than one of the main player panes. 


The following are examples: 


<AREA ... PLAYER="rtsp://helixserver.example.com/movie2.rm” ...> 
<AREA ... SEEK=0:0:2:15:0 ...> 
<AREA ... URL="http://www.example.com/page2.html” ...> 


Defining Alternate Text 


Map File 


The last parameter in the <AREA> tag must be an ALT attribute that uses short, 
descriptive text as its value. When the viewer moves the screen pointer over the 
hot spot, the alt text displays in the status line above the RealPlayer media 
playback pane, indicating what action clicking the hot spot will perform. In 
the following example, the text “Visit RealNetworks” is used for the ALT value: 


<AREA ... URL="http://www.realnetworks.com” ALT="Visit RealNetworks”> 


Example 


The following example defines an image map that is active for five minutes. 
The map creates two clickable map areas, each of which covers the entire, 360- 
pixel-by-240-pixel video. The first map area is active for the first half of the 
clip. Clicking it fast-forwards to the second half of the clip’s timeline. As the 
second half of the timeline plays, clicking the image map displays a Web page 
in the viewer’s browser. 

DURATION=0:0:5:0:0 

<MAP START=0:0:0:0:0 END=0:0:2:30:0 COORDS=0,0,360,240> 

<AREA SHAPE=RECTANGLE COORDS=0,0,360,240 SEEK=0:0:2:30:0 


ALT="Click to fast-forward to part 2."> 
</MAP> 
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<MAP START=0:0:2:30:1 END=0:0:5:0:0 COORDS=0,0,360,240> 

<AREA SHAPE=RECTANGLE COORDS=0,0,360,240 URL="http://www.example.com" 
ALT="Visit our Web site."> 

</MAP> 


Running the RMEvents Utility 


After you write your event or image file, you use the RMEvents utility to merge 
the file with your clip. This creates a new clip that includes the events or maps. 
The utility is named rmevents.exe on Windows and rmevents on Linux. You can 
find it in the RealMediaEditor subdirectory of the RealProducer installation 
directory. 


Tip: The utility needs access to the libraries in its directory, so 
you should run it from this directory, or add its directory to 
your PATH environment variable. 


For More Information: You can also use the graphical RealMedia 
editor to merge event and image files with your clip. See 
“Merging Image Maps or Events” on page 217. 


Using RMEvents Option Flags 


The following table describes the options that you use on the command line 
when running RMEvents. 


RMEvents Options 
Option Value Function 
=8 (none) Displays help. Do not use this with any other options. 
-d name Dumps events or image map information into text files. 
=@ file name Provides the path and file name of the event file. 
-i file name Gives the path and file name of the input clip. 
-m file name Indicates the path and file name of the map file. 
-0 file name Specifies the path and file name of the output clip. 


Merging an Event or Map File with the Clip 


When your event and map files are complete, you use RMEvents to merge 
them with your encoded RealAudio or RealVideo clip. Open a command-line 
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prompt and navigate to the directory that holds the RMEvents utility. Then 
give the following command, which uses four flags to indicate the input clip, 
output clip, events file, and map file. If you are not encoding a map file, for 
instance, leave out the -m command and value: 


rmevents -i input.rm -o output.rm -e events.txt -m maps.txt 
where: 

+ input.rm is the path and name of the input clip 

+ output.rm is the path and name of the output clip 

+ events.txt is the path and name of the events file 


+ maps.txt is the path and name of the map file 


Tip: Always choose a new output name so that you can save 
your original clip without any encoded events or maps. You 
cannot delete image map or events information once you have 
encoded it into a clip. You can override the information with 
new information, however. 


Extracting Map and Events Information 


Using the -d flag, you can extract map and event file information encoded into 
a clip, writing it to text files. This action does not remove the information 
from the clip, however. You specify the input clip with the -i option and a 
dump file base name along with the -d option: 


rmevents -i movie.rm -d movie 


In this example, event information is written to the file movie_evt.txt. Map 
information is written to the file movie_imap.txt. 
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CHAPTER 


14 


USING THE COMMAND-LINE APPLICATION 


This chapter explains how to run the RealProducer command-line 
application, which can encode media as both clips and live 
broadcasts. The command-line application can perform the same 
encoding functions as the RealProducer graphical application, and 


provides additional features not found in the graphical application. 


Encoding From the Command Line 


The command-line application is an executable file named producer.exe on 
Windows and producer on Linux. It provides the same encoding capabilities as 
the RealProducer graphical application, and allows you to perform batch 
encoding on any number of media files. You can run the application from the 
command line manually, or tie the application into any production or 
scripting system that can use your operating system’s command line. 


Using Job Files or Command Options 


There are two basic ways to use the command-line application. You can enter 
all of the encoding information on the command line when you run the 
application. Or, when you use RealProducer Plus, you can define the encoding 
options in a job file, as described in Appendix B, and process the job file 
through the command line. Both methods allow you to specify the same 
general encoding options, but each method provides its own advantages: 


+ When you use a job file, you can define multiple inputs and outputs that 
are encoded in parallel. Without a job file, you can define a single input 
and single output for each encoding session. A single output can have 
multiple destinations, however. For example, you can send an encoded 
output to a broadcast server as well as save it to a local file. 


- If you do not use a job file, you can use batch encoding. This allows you to 
process multiple clips one after the other, all with the same encoding 
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settings. This is useful if you need to encode a lot of clips using the same 
settings. 


Running the Command-Line Application 


The command-line application uses the command name producer. This 
executable file is located in the main RealProducer installation directory. On 
Windows, the RealProducer installer adds this directory to your Path 
environment variable, so you can run the application from any directory. On 
Linux, you can add this directory to your path through your login shell. The 
RealProducer installer can also create a symbolic link to the command-line 
application. 


File Locations and Temporary Directory 


RealNetworks recommends that you run the command-line application from 
a directory other than the RealProducer installation directory. Your media 
files can be located anywhere on your network, but it is easiest to encode them 
from the directory in which you run the command-line application. For 
fastest operation, encode output on the same disk that holds input files, 
preferably the local RealProducer disk. Also, set the temporary directory to a 
directory on the same disk used for output. 


For More Information: The section “Changing the File Location 
Preferences” on page 149 explains how to set the temporary 
directory through the graphical application. You can also 
define the temporary directory in the preferences file, which 
Appendix E describes. 


Command Line Syntax 


To run the application, open a command line prompt and navigate to your 
content directory. Then enter the producer executable name along with your 
options, as shown in the following example: 


producer -i movie.avi -o movie_streaming.rm ...additional options... 


Notes About the Command-Line Syntax 
Note the following about the command syntax: 


- Each option is preceded by a dash, as in -i. Options are from one to three 
characters long. 
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+ Some options, such as -i and -o require values, as shown above. Other 
options do not take values. 


- An option’s value immediately follows the option. Separate the two with a 
space. 


- If an option value uses multiple words separated by spaces, enclose the 
entire option string in double or single quotation marks. Do not include 
the option flag itself with in the marks. 


+ If you do not include an option on the command line, the option’s default 
value applies to the encoding job. 


+ The order of options on the command line does not matter. 


+ The command-line application supports cross-platform file naming, as 
described in “File and Directory Paths” on page 302. 


Stopping the Command-Line Application 


You can stop an encoding session and save the resulting clip by pressing 
Ctrl+c. With SureStream clips, however, some merging time is required before 
the final output is written. To cancel encoding and delete the output and 
temporary files, press Ctrl+\ on Linux or Ctrl+Break on Windows (Break is on 
the upper-right row of the keyboard). 


Sending Signals to the Linux Command-Line Application 


On Linux, the command-line application listens to and responds to signals 
that notify it of important events. The kill command can use signal names or 
numbers as arguments to send the application a signal. The kill command 
takes two arguments: the signal name or number and the process ID: 


kill signal process_id 


Signals and Actions 


The following table defines the signals to which the command-line 
application responds. 


Linux Signals and Actions 


Signal Name Signal Number Action 
SIGINT 2 Stop 
SIGTERM 15 Stop 


(Table Page 1 of 2) 
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Linux Signals and Actions (continued) 


Signal Name Signal Number Action 
SIGQUIT 3 Cancel 
SIGABRT 6 Cancel 


(Table Page 2 of 2) 


Note: No action results from sending a SIGHUP signal to the 
command-line application. 


Process IDs 

The kill command’s second argument is the process ID. A single instance of 
RealProducer runs under several process IDs, but only one ID will accept a 
signal. To identify the correct ID, use the Process ID File (-pid) option (see 
page 276) to get the process ID. The following is an example: 


producer -ac 0 -o out.rm -pid /tmp/producer.pid 


Stop and Cancel Signals 


To stop encoding but save the encoded output, use the kill command with a 
SIGINT signal as shown in the following example: 


kill -SIGINT $(cat /tmp/producer.pid) 


To cancel encoding and delete the output, use the kill command with a 
SIGQUIT signal as follows: 


kill -SIGQUIT $(cat /tmp/producer.pid) 


Tip: RealProducer includes a sample command-line utility, 
signalproducer, that sends signals to a running command-line 
application. This utility is available in source and binary 
formats in the samples/utilities/producer_signal_generator 
directory. 


Sending Signals to the Windows Command-Line Application 


On Windows, the RealProducer command-line application listens for window 
messages sent to its window handle. When the application starts, it registers a 
window handle based on the process ID (PID). You can obtain the PID from 
the Windows Task Manager. Or, you can record the PID using the Process ID 
File (-pid) option (see page 276), as shown in the following example: 


producer -ac 0 -o out.rm -pid "c:\pid.txt" 
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With the PID, you can send a stop or cancel request to the application by 
using a utility available as source and in binary form (signalproducer.exe) in the 
following directory under the main RealProducer installation directory: 


samples \utilities\producer_signal_generator 

The signalproducer.exe utility uses the following syntax, in which the stop 
option saves the output and cancel option discards it: 

signalproducer.exe {-p PID|-P PIDFILE} [-a stop|cancel] [-q] 

The following example shows how to send a cancel signal to the command- 
line application using a PID file: 

signalproducer.exe -P c:\pid.txt -a cancel 

You can also pass the PID directly using a lowercase -p option, as shown in the 
following example: 


signalproducer.exe -p 2096 -a cancel 


Monitoring the Return Value 


You can use the command-line application’s return value to detect if an error 
occurred if you run the application from a script. The application returns a 
value of 0 if no errors occurred during encoding. If errors occurred, the 
application returns a value of 1. 


Getting the Return Value on Linux 


On Linux, you can access the return code by assigning the function call to a 
variable, then testing that variable's value. The return value is stored in a 
special shell variable ($?). The following sample script checks the contents of 
the ? variable for an error. If the variable has a value of 1 or higher, the script 
prints an error string: 


producer -i movie.mpeg 
if [ $? -ge 1]; then echo "Encoding error occurred." 


Getting the Return Value on Windows 


DOS stores the return value of a command-line program in an environment 
variable called ERRORLEVEL. This following example checks the contents of 
ERRORLEVEL and prints an error string if ERRORLEVEL has a value of 1 or more: 


producer -i movie.avi 
IF ERRORLEVEL 1 echo Encoding error occurred. 
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Command-Line Functional Areas 


The following tables summarize the major functional areas and options for 


using the RealProducer command-line application. 


Job File Options 


Option Value Default Function Reference 

-j job file (none) Indicates the job file to use. page 249 

-Cj new job file input file Creates a new job file. page 249 

name 

-duc (none) (none) Disables codec updating. page 251 

Input Options 

Option Value Default Function Reference 

-ac integer|string| | (none) Specifies the audio capture page 253 
device name input device ID. 

-ap integer|string| | capturecard | Indicates the port of the audio | page 253 
device name default capture input. 

-cm (none) stereo Forces mono audio capture. page 254 

capture Linux only. 

-CS WidthxHeight capture card | Defines the input video page 256 

default dimensions. 

-i file name (none) Sets the input file name. page 252 

-VC integer|string| | (none) Specifies the video capture page 254 
device name input device ID. 

-vf NTSC|NTSC-JP| | NTSC Specifies the video format of | page 255 
PAL|PAL-M| the video capture device. Linux 
PAL-N|PAL-NC| only, 

SECAM|integer 

-vp integer|string| | capturecard | Indicates the port of the video | page 255 

device name default capture input. 
Clip Information Options 

Option Value Default Function Reference 

-a string |(none) | Encodes an author name. page 257 

-C string |(none) | Sets the encoded copyright. page 257 

-de string |(none) | Adds aclip description. page 257 
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Clip Information Options (continued) 


Option Value Default Function Reference 
-k string |(none) | Adds keywords. page 257 
if Oto6 |0 Rates the content of the output. page 258 
-t string |(none) | Adds atitle. page 257 


(Table Page 2 of 2) 


Prefilter Options 


Option Value Default Function Reference 
-ag -48 to 48 0 Adjusts the audio gain. page 258 
-bl (none) (none) Increases video contrast. page 259 
-cr Left, Top, Width, (none) Sets cropping parameters in page 260 
Height pixels. 
-daw (none) (none) Disables audio tests. page 259 
-di auto|both|d|i (none) Applies de-interlace or inverse- | page 259 
telecine filters. 
-nf low|high (none) Removes video distortions. page 261 


Output and Destination Options 


Option Value Function Reference 

-drs Megabytes Starts a new output file by size. page 262 

-drt dd:hh:mm:ss Starts a new output file by encoding time. page 262 

-0 file name Specifies the output file name and path. page 261 

-sp broadcast string | Creates an account-based, password-only, or | page 262 
multicast push broadcast. 

-Sg broadcast string | Initiates a broadcast to a legacy RealSystem | page 266 
Server. 

-si broadcast string | Starts encoding a broadcast stream in pull page 265 
mode. 

-sd broadcast string | Creates any type of broadcast using a server | page 267 


destination template or file. 
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Encoding Options 


Option Value Default = Function Reference 
-ad audience name| |system | Defines the encoding audiences. | page 269 
file name defaults 
-am voice|music music | Sets the audio type. page 271 
-arg fast|high high Sets the audio resampling quality. | page 272 
-da (none) (none) | Disables audio from the input. page 271 
-dt (none) (none) | Disables two-pass encoding page 270 
-dv (none) (none) | Disables video from the input. page 272 
-eco low|medium|high | high Sets the video or lossless audio page 274 
complexity. 
-1q fast|high high Determines the resize quality. page 273 
“1S WidthxHeight 0x0 Sets the resizing dimensions. page 273 
-vcO rv8|rv9|rv10 rv10 Chooses the RealVideo codec. page 273 
-vm normal|sharp| normal | Affects the video’s visual quality, | page 272 
smooth|slideshow primarily at lower bandwidths. 
Logging Options 
Option Value Function Reference 
-dlf (none) Disable logging to the standard log file. page 275 
-dls (none) Disable logging to the screen. page 275 
-le elwlild Determine the types of messages logged. page 274 
-pid filename | Create a process ID file. page 276 
-q (none) Display no information on the screen. page 275 
Help Options 
Option Function Reference 
-h Displays a list of available commands. page 276 
-m Provides full help for command line operation. page 276 
-pa Prints audience definitions for use with the -ad option. page 277 
-pd Displays device information for use with live capture. page 276 
-ps Prints server definitions for use with the -sd option. page 277 
-V Displays the RealProducer version number. page 277 
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Job File Options 


Job files, which use the file extension .rpjf, are XML-formatted files that 
specify the inputs, outputs, and encoding operations to perform. Appendix B 
explains the job file syntax. This section explains the options for using and 
creating job files with the command-line application of RealProducer Plus. 
Job file processing is not available with the command-line application of 
RealProducer Basic. 


Job File Name (-j) 


Use the -j option to specify the path and file name of the job file to use. You 
can use either a relative path from the current directory, or an absolute path. 
For example: 


-j MyJob.rpjf 


When you encode with a job file, the job file defines the input and output, as 
well as the encoding options. You therefore cannot use most other options on 
the command line. The following options are allowable, however, along with 
the -j option: 


+ Create Job File (-cj) option (see page 249) 

+ Disable Codec Updates (-duc) option (see page 251) 

+ Disable Audio Watchdogs (-daw) option (see page 259) 

+ Logging Category (-Ic) option (see page 274) 

+ Process ID File (-pid) option (see page 276) 

+ Video Codec Override (-vco) option (see page 273) 

- Encoding Complexity Override (-eco) option (see page 274) 
For More Information: See “Job File Examples” on page 278 for 
samples of command-line syntax for encoding clips or 
broadcasts with job files. “Job File Syntax Update” on page 279 


shows how to update earlier job files to the RealProducer 10 
format. 


Create Job File (-cj) 


If you have RealProducer Plus, you can use the -cj option to generate a job file 
from the command line options you provide. This allows you to capture 
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command-line settings into a job file without encoding any content. You can 
later run the job file you created and perform the encoding by using the -j 
option. For instance, you may want to create a basic job file using the -cj 
option, then modify it manually as described in Appendix B before running it 
on the command line. 


The value for the -cj option is a file name and path, which can be absolute or 
relative to your current directory. For example: 

-cj NewJob.rpjf 

-cj c:\Jobs\NewJob. rpjf 

-cj /usr/realproducer/jobs/NewJob.rpjf 


Warning! Job file properties are not validated until the job 
runs. You can create an invalid job file by specifying a non- 
existent audience, for example. In this case, you do not receive 
an error until you encode a job using the file. 


Input and Output Options 


The simplest way to create a job file is to specify an input file, a job file name, 
and the other encoding options on the command line. The following example 
creates the job file movie.rpjf. This file specifies movie.avi as the job input. It 
automatically sets the job output to movie.rm or movie.rmvb depending on the 
audiences chosen as part of the encoding options: 


-i movie.avi -cj movie.rpjf ...encoding options... 


To set the output clip to a different name, you include the -o option on the 
command-line: 


-i movie.avi -o streaming_movie.rm -cj movie.rpjf ...encoding options... 
For More Information: For more on defining inputs, refer to 


“Input File or Directory (-i)” on page 252. The section “Output 
File or Directory (-o)” on page 261 describes outputs. 


Batch Job File Creation 


You can create job files in batch mode by specifying an existing directory as 
the value of the -cj option. For example, you can create a job file for every AVI 
clip in a directory. In the following example, an input named movie.avi results 
in a job file named movie.rpjf in the jobfiles directory: 


-i c:\media\videos\*.avi -cj c:\media\jobfiles 
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You can also specify just the input directory, as shown in the following 
example. RealProducer creates a job file for every media file in an acceptable 
input format, such as AVI, WAVE, or MPEG, that it finds in the input 
directory. It ignores files in other formats, such as .rm and .txt files: 


-i /usr/producer/media/videos -cj /usr/producer/media/jobfiles 


Disable Codec Updates (-duc) 


When you have job or audience files created with the older Helix Producer, 
RealProducer 10 automatically updates the audience settings to use new audio 
and video codecs. This is the recommended action. Job or audience files that 
formerly specified the RealVideo G2 with SVT codec are updated to use 
RealVideo 8. The following table lists the RealAudio codecs substituted for 
older audio codecs. 


Automatic RealAudio Codec Updating 


Previous RealAudio Codec New RealAudio Codec 

66 Kbps Stereo Music - RA8 64 Kbps Stereo Music 

94 Kbps Stereo Music - RA8 96 Kbps Stereo Music 

105 Kbps Stereo Music - RA8 96 Kbps Stereo Music 

132 Kbps Stereo Music - RA8 128 Kbps Stereo Music - RealAudio 10 
146 Kbps Stereo Music - RA8 128 Kbps Stereo Music - RealAudio 10 
176 Kbps Stereo Music - RA8 160 Kbps Stereo Music - RealAudio 10 
264 Kbps Stereo Music - RA8 256 Kbps Stereo Music - RealAudio 10 
352 Kbps Stereo Music - RA8 320 Kbps Stereo Music - RealAudio 10 
132 Kbps Surround Audio 128 Kbps Stereo Surround - RealAudio 10 
146 Kbps Surround Audio 128 Kbps Stereo Surround - RealAudio 10 
176 Kbps Surround Audio 160 Kbps Stereo Surround - RealAudio 10 
264 Kbps Surround Audio 256 Kbps Stereo Surround - RealAudio 10 
352 Kbps Surround Audio 320 Kbps Stereo Surround - RealAudio 10 


If you want your audience or job files to retain the older codec information, 
however, you can include the -duc option on the command line: 


-duc 


Warning! RealProducer 10 no longer includes the RealVideo G2 
codec, or RealAudio codecs based on ATRACS3 technology. If 
your existing audience or job files specify these codecs and you 
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include the -duc option, RealProducer 10 will not be able to 
encode the job. 


Tip: You can modify how RealProducer updates older codecs by 
modifying the settings of the codecmapping.txt file located in 
the resources directory under the RealProducer installation 
directory. You will need to know the codec names and flavors, 
which are listed in the codec tables in the section “RealAudio 
Codecs” on page 35. 


Input Options 
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This section describes the input options that allow you to specify a file or live 
capture as the input to be encoded. Note that you can specify just one input 
through the command line. In a job file, however, you can specify multiple 
inputs that are run in parallel, as described in “Audio and Video Inputs” on 
page 299. 


Input File or Directory (-i) 


Use the -i option to indicate a digitized file on the network or local drive to be 
encoded. For the file path, you can specify either a relative path from the 
current directory, or an absolute path. The input file name is ignored if the 
Audio Capture Device ID (-ac) option (see page 253) or Video Capture Device 
ID (-vc) option (see page 254) is specified. 


For More Information: For a list of supported input file types, 
refer to “Audio and Video Input Formats” on page 25. For 
information about specifying output file locations and names, 
see “Output File or Directory (-o)” on page 261. 


Single File Input Examples 


-i moviel.mpg 

-i ../media/moviel.mpg 
-i_c:\files\media\moviel.avi 

-i /home/encoder/media/movie1l.mpg 


Batch File Encoding 


With RealProducer Plus, you can specify multiple files that are encoded 
serially. You can specify the directory that contains the source files, or use one 
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or more asterisks (*) as wildcards in file names. You cannot use a wildcard in a 
directory path, however. If you do not specify output paths and names, the 
encoded clips are written to the input directory, using each input’s base file 
name and the .rm or .rmvb extension, depending on the encoding type. 


Batch File Input Examples 


-i *.mpg 

-i ../media/ 

-i c:\files\media\ 

-i c:\files\media\trailer* avi 

-i /home/encoder/media/*.mpg 
-i /home/encoder/media/ 


Audio Capture Device ID (-ac) 


The -ac option specifies the audio device ID for the input audio device. Using 
this option overrides the -i option for a file input. You can use one of the 
following values: 


+ Integer of value 0 or higher identifying a specific device number, such as: 
-ac 0 

- String matching an existing device name: 
-ac “Sound Blaster Live!” 

+ String with a wildcard (*) matching an existing device name, such as: 
-ac “Sound Blaster *” 

+ UNIX device name or symbolic link to a device name, such as: 


-ac /dev/audio 


For More Information: Use the Print Device Information (-pd) 
option (see page 276) to list values for your system. 


Audio Capture Device Port (-ap) 


Use -ap to specify the port for the audio device used for audio capture. You 
must specify the audio device ID as well. Using the -ap option overrides the -i 
option for a file input. If you omit the audio port, the current mixer settings 
are used. You can use one of the following values: 


+ Integer of value 0 or higher identifying a specific port number, such as: 


-apo 
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- String matching an existing port name: 
-ap “Line In” 
+ String with a wildcard (*) matching an existing port name, such as: 
-ap “Mic*” 
Note: This option is not available on Windows or on Linux 
distributions that use the free OSS audio drivers. Instead, set 
the audio capture port using the Windows Recording Control 


Panel. On Linux, use mixer software specific to your Linux 
distribution. 


For More Information: Use the Print Device Information (-pd) 
option (see page 276) to list values for your system. 


Capture Mono Audio (-cm) 


The Linux-only -cm option forces the audio card to record a single, mono 
audio channel. Omitting the option enables stereo capture. The option does 


not require any values: 
-cm 
Tip: When capturing mono-only, you'll get best results when 


using one of the mono codecs listed in “Voice Codecs” on page 
37 or “Mono Music Codecs” on page 38. 


Video Capture Device ID (-vc) 


Use -vc to set the device ID for the input video device. Using this option 


overrides the -i option for a file input. You can use one of the following values: 
+ Integer of value 0 or higher identifying a specific device number: 
-vc 1 
- String matching an existing device name: 
-vc “Osprey Capture Card 1” 
+ String with a wildcard (*) matching an existing device name, such as: 
-vc “Osprey*” 
+ UNIX device name or symbolic link to a device name, such as: 


-vc /dev/video3 
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For More Information: Use the Print Device Information (-pd) 
option (see page 276) to list values for your system. 


Video Device Port (-vp) 


The -vp option sets the port for the video capture device. If you use -vp, you 
must specify the video device ID as well. Using the -vp option overrides the -i 
option for a file input. If you omit the port, the current mixer settings are 
used. You can use one of the following values: 


+ Integer of value 0 or higher identifying a port number, such as: 
-vp 1 

- String matching an existing port name: 
-vp “S-Video” 

+ String with a wildcard (*) matching an existing port name, such as: 
-vp “Composite*” 


Note: This option is not available with Video for Windows 
(VFW) devices. Instead, use the graphical application to set the 
port through the capture card dialog. See “Using Live Audio or 
Video as the Input” on page 88 for instructions. 


For More Information: Use the Print Device Information (-pd) 
option (see page 276) to list values for your system. 


Video Format (-vf) 


The -vf option defines the video format on Linux only. It specifies the video 
format of the video capture device. On Windows, use the driver dialog to set 
the video format. This option is ignored if you do not also use the Video 
Capture Device ID (-vc) option. The default is NTSC. The following are the 
possible values: 


» NTSC 

- NTSC-JP 
- PAL 

» PAL-M 

» PAL-N 

» PAL-NC 
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» SECAM 


+ integer (specifies a format understood by your video driver) 
Here are some examples: 


-vf SECAM 
-vf 8 


Capture Frame Size (-cs) 


The -cs option sets the size of the video capture when you use the Video 
Capture Device ID (-vc) option (see page 254). It is ignored for audio-only and 
file-to-file encoding. If you do not specify this size, the dimensions set in the 
video capture card are used. The value specifies pixel dimensions in the form 
WidthxHeight, as shown in the following example: 


-cs 320x240 


Note: The RealVideo codec rounds each dimension down to 
the nearest 4 pixels. If you specify a height of 183 pixels, for 
example, the output clip has a height of 180 pixels. 


For More Information: You can resize any video output, whether 
from a capture or with file-to-file encoding. See “Resize Video 
(-rs)” on page 273. 


Capture Duration (-d) 


The -d option sets the duration that the audio or video capture lasts. This is 
not used when encoding from a file. The duration timer begins when you start 
the encoding. If you omit this option, encoding lasts until you stop it 
manually. The section “Duration Syntax” on page 288 explains how to specify 
time values. Here are some examples: 


-d 90 Encode for 90 seconds. 
-d 10:30 Encode for ten hours and 30 seconds. 
-d 1:00:00 Encode for one hour. 


Clip Information Options 


The following clip information options are available through the command- 
line application. Adding clip information is highly recommended. For 
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background on the information values, refer to “Adding Clip Information” on 
page 92. 


Title (-t) 


The -t option defines a title for the clip or broadcast. The value can be any 
string up to 255 characters. For example: 


-t “2004 Music Awards” 


Author (-a) 


Use the -a option to define the author of the clip or broadcast. The value can 
be any string up to 255 characters. For example: 


-a “Brilliant Media Limited” 


Copyright (-c) 


The -c option defines the copyright owner and date for the recorded clip. The 
value can be any string up to 255 characters. For example: 


-c “2004 Brilliant Media Limited” 


Keywords (-k) 


Using the -k option, you can define keywords that help search engines index 
your clip. The value can be any string up to 255 characters. For example: 


-k “awards 2004 music” 


Description (-de) 


Using the -de option, you can set a description of the clip that is longer and 
more informative than the title. The value can be any string up to 64 Kilobytes 
in size. For example: 


-de “An encore presentation of the 2004 music awards.” 
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Content Rating (-r) 


The -r option defines the age range for which the content is applicable. Use 
one of the following integer values (0 is the default): 


No rating 

All ages 

Older children 
Younger teens 
Older teens 


Adult supervision recommended 


Nn nA Lh WO NY F CO 


Adults only 


For example: 


-r1 


Prefilter Options 
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The following prefilter options are available through the command-line 
application. A prefilter modifies the audio or video input before it is encoded. 
Because all prefiltering is optional, no prefilters are applied by default. 


Note: You cannot apply the audio compensation prefilter, 
which adjusts audio that is out of synchronization with video, 
through the command line. You can specify this prefilter in a 
job file, however. See “Audio Delay Compensation Prefilter” on 
page 317. 


Audio Gain Filter (-ag) 


The -ag option applies the audio gain filter to amplify or attenuate the input 
audio. This can boost the audio signal or decrease it to prevent it from 
clipping. The value is a number from -48.0 (attenuation) to 48.0 
(amplification). For example: 


-ag -5.0 


For More Information: For background on audio gain, refer to 
“Monitoring Audio” on page 142. 
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Disable Audio Watchdogs (-daw) 


The -daw option disables the audio watchdogs, which are a set of tests that 
RealProducer runs on the audio input to detect audio problems. You can use 
them when encoding from a file or a live capture, but they are most useful 
when capturing live media because you may be able to correct the problem 
through the capture equipment. Any audio problems discovered are logged 
periodically (typically every five seconds) while the problem persists. After 
logging 20 messages for the same problem, RealProducer suspends logging of 
that message for 16 hours. The following table describes the watchdog tests. 


Audio Watchdog Tests 
Test Test Condition 
Out-of-Phase Indicates that the audio signal has been out of phase for more 
than 10 seconds. 
Clipping Warns that the audio is being clipped heavily, moderately, or 
lightly. 
Silence Detects if the audio input signal has been below -60dB for 


longer than 10 seconds. 


Channel Imbalance | For stereo input, indicates that one channel has been 6dB lower 
than the other channel for more than 10 seconds. 


The option does not require a value, as shown here: 


-daw 


Black Level Filter (-bl) 


This filter increases contrast in videos by making dark colors pure black and 
off-white colors pure white. The option does not require a value: 


-bl 


For More Information: The section “Black-Level Correction 
Filter” on page 78 describes this filter. 


Inverse-Telecine and De-interlace Filters (-di) 


The -di option specifies the use of the inverse-telecine or de-interlace filter on 
the video input. The de-interlace filter is generally needed only on videos 
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larger than 320 by 240. The inverse-telecine filter is for videos that were 

transferred from film. The following are the values that you can specify. 

auto Autodetect and apply both filters only if needed. This is recommended. 
d Apply the de-interlace filter only. 

i Apply the inverse-telecine filter only. 


both Apply both the de-interlace and inverse-telecine filters. 


Here is an example: 


-di auto 
For More Information: The sections “Inverse-Telecine Filter” on 
page 76 and “De-interlace Filter” on page 77 explain how these 
filters operate. 
Crop Video Input (-cr) 


The -cr option applies the cropping prefilter, which crops out areas from the 
sides of the input video. The option uses four pixel values, separated by 
commas and no spaces. In order, these values indicate the values for Left, Top, 
Width, and Height. 


Left Represents the number of pixels from the left edge of the video to start the 
cropping. You can specify up to 32 pixels less than the total width. 


Top Sets the number of pixels from the top edge of the video to start the 
cropping. You can specify up to 32 pixels less than the total height. 


Width Defines the total width of the cropped video, measured from the point set 
by the Left property. If the width value is not a multiple of 4, the next lower 
multiple is used. For example, a value of 162 results in a video 160 pixels 
wide. 


Height Indicates the total height of the video, measured from the point set by the 
Top property. If the value is not a multiple of 4, the next lower multiple is 
used. For example, a value of 127 results in a video 124 pixels high. 


In the following example, the cropping starts 10 pixels to the right of the 
video’s left edge and 20 pixels down from the top edge. The resulting video is 
then 320 pixels wide by 240 pixels high. 


-cr 10,20,320,240 


Tip: As described in “Resize Video (-rs)” on page 273, you can 
also resize a video. Because cropping occurs first, the final two 
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numbers of the -cr value indicate the input size for the resizing 
operation. 


Video Noise Filter (-nf) 


As described in “Noise Filters” on page 75, the noise filters can remove small 
distortions in the video image. Use a value of low for small distortions, a value 
of high if the noise is more pronounced. You should not apply these filters to 
video input that is free of distortion. Here is an example: 


-nf high 


Output and Destination Options 


This section describes the output and destination options. Using the 
RealProducer Plus command-line application, you can encode a single output, 
but can send that output to any number of destinations, whether files or 
servers. With RealProducer Basic you can define one file destination and one 
server destination for each encoding session. 


For More Information: If you create a job file, you can specify 
multiple outputs, each of which may have different encoding 
options and destinations. See “File and Server Outputs” on 
page 319 


Output File or Directory (-o) 


The -o option sets the output clip’s file name and path to an existing 
directory. The path can be absolute or relative to the current directory. You 
must supply a file name for captured input. With file-to-file encoding, you can 
omit the -o option to encode the clip using the input file’s base file name and 
the appropriate extension, either .rm for constant bit rate clips or .rmvb for 
variable bit rate clips. In this case, the output clip is saved to the directory that 
holds the input file. The following examples specify output paths and file 
names: 

-o C:\Movies\moviel.rm 

-o /usr/producer/output/movie2.rmvb 


Batch Output Encoding 


As described in “Batch File Encoding” on page 252, you can encode multiple 
input files using wildcards. In this case, you do not need to specify the outputs 
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to save the encoded clips in the directory that holds the input files. The 
outputs will use the input files’ base file names along with the .rm or .rmvb 
extension. You can use the -o option to specify an output directory, however, if 
you want to save the clips in a different directory: 

-o C:\Movies 

-o /usr/producer/output/ 


Archive Clips 


If you specify the name of clip that exists already in the output directory, 
RealProducer does not overwrite the existing clip. Instead, it archives the 
existing clip by appending _archNNN to the base file name. Hence, movie.rm 
becomes movie_arch001.rm before the new movie.rm clip is saved. If you encode 
the output again, the existing movie.rm becomes movie_arch002.rm. Higher 
numbers therefore represent newer archives. 


Destination File Roll Size (-drs) 


Use the -drs option to set an file size limit in Megabytes that causes 
RealProducer to create a new output file. The section “File Rolling” on page 
322 explains how file rolling works. The following example sets a roll size of 
20 Megabytes: 


-drs 20 


Destination File Roll Time (-drt) 


The -drt option sets an encoding duration after which RealProducer creates a 
new output file. The section “File Rolling” on page 322 explains how file 
rolling works. See “Duration Syntax” on page 288 for information about 
timing values you can use. The following example creates a new file archive 
after RealProducer has encoded the output for 15 minutes: 


-drt 15:00 


Push Server Destination (-sp) 


The -sp option defines a push broadcast with Helix Server version 9 or later as 
the destination. You can perform an account-based push, password-only push, 
or multicast (RealProducer Plus only). Before running a push broadcast, 
review the broadcast issues described in Chapter 10 and be sure that you 
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understand the broadcast features and server set-up requirements for your 
chosen type of broadcast, as described in one of the following sections: 


- “Running an Account-Based Broadcast” on page 179 
+ “Setting Up a Password-Only Broadcast” on page 184 


- “Multicasting a Live Stream” on page 189 


Push Server Syntax 
This broadcasting method uses the following syntax: 
-sp username:password@address:port/path/stream 
As the following table explains, you may not need to define every component 


in the broadcast stream, depending on the broadcast type and the server 
settings. 


Push Destination Components 


Component Value 


username | User name defined in the Helix Server authentication database. Used 
only with account-based broadcasts. If no server authentication is 
required for account-based push, omit both the user name and the 
password. 


password | Password defined in the Helix Server authentication database (account- 
based) or the receiver definition (password-only, multicast). If you 
supply only the password, RealProducer assumes a password-only 
broadcast or multicast. The Helix Server receiver must be set to use the 
Basic authentication method. 


address Valid IP address or domain name for the Helix Server destination. For 
multicasts, the value must be a class-D multicast address. 


port Server port that receives the stream. For account-based broadcasts, the 
default is 80, which is typically the server’s HTTP port. Use a different 
value if the server uses a different HTTP port. For password-only and 
multicasts, the receiver typically accepts connections on ports 30001 
through 30020. The default value for these broadcast types is 30001. 


path Optional, virtual path used to define server-side archiving or stream 
splitting. For background, refer to “Virtual Paths” on page 174. 


stream The name of the broadcast stream. Include the .rm or .rmvb file 
extension, as in live.rm. The name can not contain the following 
characters: @ : / 
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Default Broadcast Values 


The -sp broadcasting option does not allow you to set advanced broadcast 
parameters such as the transport type and error correction features, which the 
section “Changing Advanced Push Broadcast Parameters” on page 194 
describes. Nor can you set the listen address if you are broadcasting through a 
firewall performing network address translation (NAT). Instead, this 
broadcasting option uses the default values for these features. 


For More Information: If you need to change default values for 
advanced broadcast features, use the Server Template or Server 
File (-sd) option (see page 267), or define the broadcasting 
options in a job file. 


Push Broadcast Examples 


The following examples show how to perform one of the three possible 
broadcast types using the -sp option. 


Account-Based Broadcast Example 

The presence of a user name and password causes RealProducer to start an 
account-based broadcast. In the following example, the port value is included 
because the server does not use port 80 for HTTP requests. No virtual path is 


given, and the stream name is news.rm. 

-sp remote_encoder:as45er897 @helixserver.example.com:8080/news.rm 

If authentication is not required on the server, you can omit the user name, 
password, and @ sign: 


-sp helixserver.example.com:8080/news.rm 


Password-Only Broadcast Example 


The presence of a password but no user name, along with a non-multicast IP 
address or DNS name, starts a password-only broadcast. In the following 
example, the port value is not given, so RealProducer delivers the stream to the 
default port 30001. A virtual path used by the server is provided, along with 
the stream name live.rm. 


-sp TY45poiu@helixserver.example.com/sports/live.rm 


Multicast Example 
The presence of a password but no user name, along with a multicast IP 


address, starts a password-only broadcast. In the following example, the port 
value of 30011 is supplied. No virtual path is used with the stream name. 
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-sp 569ad42k@224.0.0.1:30011/playoffs.rm 


Pull Server Destination (-si) 


The -si option defines a pull broadcast accessible by Helix Server version 9 or 
later. Before running a pull broadcast, review the broadcast issues described in 
Chapter 10 and be sure that you understand the broadcast features and server 
set-up requirements described in “Running a Pull Broadcast” on page 202. 


Pull Server Syntax 
This broadcasting method uses the following syntax: 


-si password@listenAddress:listenPort/path/stream 


As the following table explains, you may not need to define every component 
in the broadcast stream, depending on the server settings. 


Pull Destination Components 


Component Value 


password Password used by RealProducer to authenticate server pull requests. 
The Helix Server receiver must supply this password. If you omit 
this, any pull-enabled server can connect to the stream. 


listenAddress Valid IP address to which RealProducer binds. The default of 0 uses 
the default IP Address on the default network interface card. See “IP 
Address Values” on page 266 for information about displaying the 
IP addresses. 


listenPort Port that RealProducer uses to listen for pull requests. The default is 
3031, 
path Optional, virtual path used to define server-side archiving or stream 


splitting. For background, refer to “Virtual Paths” on page 174. 


stream The name of the broadcast stream. Include the .rm or .rmvb file 
extension, as in live.rm. The name can not contain the following 
characters: @ : / 


Default Broadcast Values 


With pull broadcasting, the server that pulls the stream defines most of the 
advanced stream features, such as error correction. RealProducer defines a few 
advanced parameters, however, which the section “Defining a Pull Broadcast 
Server Destination” on page 205 describes. When you use the -si option, the 
command-line application uses the default settings. 
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For More Information: If you need to change default values for 
advanced broadcast features, use the Server Template or Server 
File (-sd) option (see page 267), or define the broadcasting 
options in a job file. 


IP Address Values 


To find the listen address of the RealProducer machine where the command 
line application is running, do the following: 


+ On the Linux command line, type the following to display the IP address 
on the screen: 


ifconfig 

+ On Windows NT/2000/XP, open a command prompt and type the 
following to display the IP address on the screen: 
ipconfig 

+ On Windows ME/98SE, open a command prompt and type the following 


to open a dialog that allows you to select different network cards and view 
their IP addresses: 


winipcfg 


Pull Broadcast Examples 


The following example shows how to start a pull broadcast using the -si 
option and specifying all possible values, including a virtual path name: 


-si dkgy435ty@192.168.224.221:3031/rock/radio.rm 


To use the RealProducer default IP address and listen port, you would use a 


value such as the following. This example does not include a virtual path with 
the stream name: 


-si dkgy435ty@0/radio.rm 


Legacy Push Server (-sg) 


The -sg option defines a push broadcast to a version of RealSystem Server that 
predates Helix Server version 9. It is available only with RealProducer Plus. 
Before running a legacy broadcast, review the broadcast issues described in 
Chapter 10 and be sure that you understand the broadcast features and server 
set-up requirements described in “Setting up a Legacy Broadcast” on page 199. 
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Legacy Push Server Syntax 
This broadcasting method uses the following syntax: 
-sg username:password@address:port/path/stream 
As the following table explains, you may not need to define every component 


in the broadcast stream, depending on the broadcast type and the server 
settings. 


Legacy Push Destination Components 


Component Value 


username __| User name defined in the RealSystem Server authentication database. 
If no server authentication is required for legacy push, omit both the 
user name and the password. 


password | Password defined in the RealSystem Server authentication database. 


address Valid IP address or domain name for the RealSystem Server 
destination. 

port Server port that receives the stream. The default is 4040. 

path Optional, virtual path used to define server-side archiving or stream 


splitting. For background, refer to “Virtual Paths” on page 174. 


stream The name of the broadcast stream. Include the .rm file extension, as in 
live.rm. The name can not contain the following characters: @ : / 


Legacy Broadcast Example 


The following example shows how to perform a legacy broadcast using the -sg 
option. No virtual path is given, and the stream name is news.rm: 


-sg encoder:as45er897 @realserver.example.com:4040/news.rm 


Server Template or Server File (-sd) 


Available with RealProducer Plus, the -sd option allows you to broadcast in 
pull or push mode using a predefined server destination. When you use this 
option, a server destination template or file sets the necessary broadcast 
parameters, such as the server’s IP address, transport method, and advanced 
parameters like error correction. This is the most flexible means of 


broadcasting, but requires the use of a separate, server destination template or 
file. 


For More Information: Chapter 11 covers the different 
broadcasting methods and explains how to create a server 
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destination using the graphical application. Appendix D 
explains the server file syntax. 


Server Destination Syntax 
This broadcasting method uses the following syntax: 


-sd username:password@definition, path/stream 


As the following table explains, you may not need to define every component 
in the -sd option’s value, depending on the broadcast type. 


Server Definition Broadcast Components 


Component Value 


username __| User name required by the broadcasting method. If no user name is 
required, as with password-only broadcasting, omit this value. 


password | Password required by the broadcasting method. If no password is 
required, omit this value. 


definition | Name ofa server definition stored in the default server destination 
directory. Or, the path and file name of a server definition file stored 
anywhere on your network. See “Locating Server Definitions” on page 
268 


path Optional, virtual path used to define server-side archiving or stream 
splitting. For background, refer to “Virtual Paths” on page 174. 


stream The name of the broadcast stream. Include the .rm or .rmvb file 
extension, as in live.rm. The name can not contain the following 
characters: @ : / 


Locating Server Definitions 


As explained in Appendix D, a server destination file is an XML-formatted file 
that uses the extension .rpsd. To use a destination file, provide the full file 
name and extension, along with a relative or absolute path as the definition 
component. Relative paths are relative to the directory from which you run 
the command-line application. 


You can also specify a server template, which is a server destination file stored 
in the servers directory under the main RealProducer installation directory. To 
use a template, you provide the template name, which is the value of the 
destination’s name property. You can abbreviate the template name down to a 
unique set of letters. 
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Tip: Use the Print Servers (-ps) option (see page 277) to display 
a list of available server templates. 


For More Information: You can change the location of the server 
templates by editing the preferences file as described in 
Appendix E 


Server Definition Examples 


The following example specifies the absolute path to a server destination file 
that sets up an account-based broadcast. Both a user name and password are 
supplied, as required by the account-based, push broadcast method: 


-sd remote_encoder:as45er897 @/usr/encoder/pushbroadcast.rpsd,football.rm 


The next example provides the relative path to a server destination file that 
defines a password-only push broadcast. Accordingly, the -sd option value 
supplies just a password. A virtual path of hourly/ is included with the stream 
name: 


-sd yop563sdf@../definitions/SydneyReceiver.rpsd,hourly/news.rm 


The following example indicates a server destination template named Rock 
Radio Pull Broadcast stored in the default template directory. When you specify 
a template, you can abbreviate the name down to a unique set of characters, 
such as Rock in the following example: 


-sd 567dlopf212@Rock,livefeed.rm 


Encoding Options 


This section lists the general encoding options that affect the output, whether 
a clip or a broadcast stream. Use these options to select the video codec, for 
example, or specify the encoding audiences. 


Audience Definitions or Audience Files (-ad) 


The -ad option defines the audiences for which the output is encoded. You can 
use the Print Audiences (-pa) option (see page 277) to display the available 
audience definitions. You can abbreviate an audience name to a unique set of 
characters. For example, you can specify the 28k Dial-up audience by using 
28k. When you use just the audience name, RealProducer looks for the 
audience file in the location specified by the RealProducer preferences. 
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If an audience file does not reside in the default location, you can provide the 
location of the audience file, using a full or relative path along with the file 
name, including the extension (.rpad). Using either the audience name or file 
name, you can specify multiple, constant bit rate (CBR) audiences using a 
quoted, comma-separated list. With variable bit rate (VBR) video or RealAudio 
lossless encoding, you can specify only one audience. Here are examples: 

-ad 150k 

-ad "28k,56k" 

-ad "28k Dial-up,56k Dial-up,256k DSL/Cable Modem" 

-ad "C:\settings\ModemGeneralAudience.rpad" 

-ad "/files/28k.rpad,/files/56k.rpad" 


Tips for Using Audience Definitions 
Note the following about selecting audiences: 


- Using RealProducer Plus, you can add any number of CBR audiences to a 
SureStream clip. With RealProducer Basic, you are limited to three 
audiences. 


- If you specify no audiences with the -ad option and you do not use a job 
file that defines audiences, RealProducer encodes the output for the 
default audiences, which are described in the section “Default Audiences 
and Options” on page 99. 


+ Chapter 7 describes the encoding settings of the predefined audiences. 


- If you create your own audience definitions, you set the audience name 
through the name property, as described in “Audience Properties” on page 
333. 


+ RealProducer 10 automatically updates older audience files to use the 
latest codecs. You can disable this, however, with the Disable Codec 
Updates (-duc) option (see page 251). 


- The section “Adjusting RealProducer Preferences” on page 149 explains 
how to find the default location of audience files. 


Disable Two-Pass Encoding (-dt) 


By default, RealProducer reads an input file in two passes. The first pass 
analyzes the data, the second pass encodes it. The -dt option disables two-pass 
encoding so that all actions occur in a single pass. This speeds encoding time, 
but lowers the encoded quality. Use the option without any values: 
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-dt 


Automatic Disabling of Two-Pass Encoding 


Two-pass encoding is automatically disabled when you specify the following 
options for live capture: 


- Audio Capture Device ID (-ac) 
+ Video Capture Device ID (-vc) 


It is also disabled if you send output to a server using any of the following 
options: 


- Push Server Destination (-sp) 
¢ Pull Server Destination (-si) 
+ Legacy Push Server (-sg) 


- Server Template or Server File (-sd) 


Audio Mode (-am) 


Use the -am option to describe the basic audio content of the input, either 
voice or music. This determines whether a voice or audio codec is used to 
encode the audio. Values are voice or music. Because the default is music, you 
need to include this option only if encoding voice-only audio: 


-am voice 
For More Information: The actual codecs used are defined in the 
audience template. Each codec expects a certain type of input, 
such as mono, stereo, or discrete multichannel. For 
information about how an audience defines codecs, refer to 
“Audio Stream Context” on page 336. 
Disable Audio (-da) 


The -da option strips the audio from the input source. Typically, you use this 
when encoding file-to-file or capturing video input for which you do not want 
to encode audio. The option does not require a value. For example: 


-da 


Tip: Do not use the -da option when capturing audio with the 
Audio Capture Device ID (-ac) option (see page 253). Instead, 
omit the -ac option. 


271 


RealProducer 10 User’s Guide 


272 


Audio Resampling Quality (-arq) 


As explained in “Sampling Rate” on page 36, RealProducer resamples audio if 
the input does not match the sampling rate expected by the chosen RealAudio 
codec. The -arg option determines the resampling quality. The default value of 
high produces the best results, but uses more processing power than the fast 
value, shown here: 


-arq fast 


Note: Neither the fast nor the high value causes pitch shifting. 


Video Mode (-vm) 


The -vm option influences the visual quality of the encoded video. It helps you 
to balance visual clarity against frame rate, and generally has more effect on 
videos encoded for low bandwidths. You can use it to help heighten the visual 
clarity or increase the encoded frame rate. You can use one of the following 


values: 

normal The default value of normal attempts to balance frame rate and visual 
clarity. This is the best choice for most content. 

sharp The sharp value creates the sharpest image possible. Consequently, the 
encoded frame rate may be lower and the video may appear jerkier. 

smooth The smooth value produces the smoothest motion possible by increasing 


the frame rate. As a result, the video may be blurrier due to decreased 
visual clarity. 


slideshow The slideshow value encodes a frame every few seconds to create a 
slideshow. The video will have very little motion, but a high degree of 
visual clarity. You may want to use this value if you are encoding a video 
with large dimensions at a low bandwidth. 


For example: 


-vm sharp 


Disable Video (-dv) 


The -dv option strips the video out of the input source. Typically, you use this 
when encoding file-to-file and want to capture only the audio portion of a 
video clip. The option does not require a value. For example: 


-dv 
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Tip: Do not use the -dv option when capturing audio with the 
Video Capture Device ID (-vc) option (see page 254). Instead, 
omit the -ve option. 


Resize Video (-rs) 


If you have RealProducer Plus, you can use the -rs option to set the output 
video’s width and height in pixels. This option uses a value WidthxHeight, in 
which each component is an integer from 0 to 2048. The default value of 0x0 
performs no resizing. If you set a single value to 0, that dimension scales in 
proportion to the other dimension, maintaining the input clip’s aspect ratio. 
The following are examples: 


-rs 320x240 _ Resize the video to 320 pixels wide by 240 pixels high. 


-Ts 180x0 Resize the width to 180 pixels and scale the height proportionally, 
maintaining the input video’s aspect ratio. 


-rs 0x160 Resize the height to 160 pixels and scale the width proportionally, 
maintaining the input video’s aspect ratio. 


Note: The RealVideo codec rounds each dimension down to 
the nearest 4 pixels. If you specify a height of 183 pixels, for 
example, the output clip has a height of 180 pixels. 


For More Information: The Capture Frame Size (-cs) option (see 
page 256) can resize video capture input. This allows you to 
resize the encoded output by overriding the default video 
capture dimensions. 


Resize Quality (-rq) 


When you resize the encoded video using the -rs option, the -rq option affects 
the resulting quality. Using the default high value results in a higher-quality 
output, but requires considerably more processing power during encoding. 
The fast value uses less processor power, but results in lower quality: 


-rq fast 


Video Codec Override (-vco) 


Using RealProducer Plus, you can choose a video codec other than the default 
RealVideo 10. This allows you to use RealVideo 9 or RealVideo 10 for faster 
encoding, or backwards-compatibility with RealPlayer 8. The selected codec 
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encodes all video streams for the output. Acceptable values are rv10, rv9, and 
rv8, as shown here: 


-vco rv8 


Encoding Complexity Override (-eco) 


With RealProducer Plus, you can set a complexity mode, which the section 
“Encoding Complexity Modes” on page 79 explains. This mode affects 
RealVideo 9 or 10 clips, as well as RealAudio lossless clips. The default value of 
high produces the best results, but requires the most processing power. A value 
of medium or low speeds processing time, but results in lower quality for video 
clips or a larger file size for lossless audio clips. Here is an example: 


-eco medium 


Note: When you use a server as a destination, RealProducer 
automatically scales down the encoding complexity as needed. 
You therefore do not need to use this option when producing a 
broadcast. See “Broadcast Load Management” on page 174 for 
more information. 


Logging Options 
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The following options affect the messages that RealProducer creates as it 
encodes a job. The log file location is set through the RealProducer 
preferences, as described in “Adjusting RealProducer Preferences” on page 149. 


Logging Category (-lc) 


The -lc option determines the level of logging messages used, overriding the 
logging category set in the preferences. These messages are written to the log 
file or printed to the screen, depending on the other logging options you use. 
For the value, use a comma-separated string that includes any of the 
following: 


error Error messages are severe problems that typically cause the encoding 
operation to fail. 


warning Warning messages indicate possible problems that did not cause the 
encoding to fail. 
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info Informational messages convey important messages about the 
encoding operation. 


diagnostic Diagnostic messages convey non-critical messages about the encoding 
operation. Because an encoding operation may generate many 
diagnostic messages, the log file can grow rapidly when you include 
this category. 


You can abbreviate each value down to the first letter, as shown in the 
following examples: 


-lc "error,warning,info" 
-lc "err,warn,info,diag" 
-lc "e,w,i,d" 


For More Information: The section “Changing Log File and Log 
Viewer Preferences” on page 151 explains how to set logging 
preferences through the graphical application. You can also set 
these preferences manually, as described in Appendix E. 


Disable Logging to File (-dlf) 


The -dlf option disables logging to the log file. Messages may still display on 
the screen. The option takes no value: 


-dlf 


Disable Logging to Screen (-dls) 


The -dls option disables logging to the screen. Log messages may still be 
written to the log file, however. The option takes no value: 


-dls 


Quiet Mode (-q) 


The -q option prevents any information, including log messages, from being 
printed to the screen. Use this option if you are running the command-line 
application from another application that will fail if output is written to the 
standard output device. The option takes no value: 


“q 
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Process ID File (-pid) 


The -pid option writes a file that holds the process ID of the current encoding 
section. This ID is useful for shutting down the command-line application 
remotely, as described in “Stopping the Command-Line Application” on page 
243. The option uses as a value a file name and path, which can be absolute or 
relative to the current directory. Here are some examples: 


-pid ..\Jobs\job18.pid 
-pid /usr/log/job34.pid 


Help Options 


The following sections explain the help options that you can display through 
the RealProducer command-line application. 


Display Help (-h) 


Use the -h option without any other options to display a list of commands 
that you can use with the command-line application. The option does not 
require a value, as shown here: 


-h 


Display Detailed Help (-m) 


Use the -m option without any other options to display full information about 
the commands that you can use with the command-line application. The 
option does not require a value, as shown here: 


-m 


Print Device Information (-pd) 


The -pd option extracts audio and video capture device information. Use only 
this option without a value on the command line: 


-pd 

You can use the returned device information with the following options: 
- Audio Capture Device ID (-ac) option (see page 253) 
- Audio Capture Device Port (-ap) option (see page 253) 
- Video Capture Device ID (-vc) option (see page 254) 
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+ Video Device Port (-vp) option (see page 255) 


Tip: If the -pd option does not return audio port information 
on Linux, use mixer software to adjust the input audio port. 


Print Audiences (-pa) 


This option prints a list of acceptable audiences that you can use with the 
Audience Definitions or Audience Files (-ad) option (see page 269). Use only 
this option on the command line. It does not require a value: 


-pa 


Print Servers (-ps) 


Use the -ps option alone on the command line to list the accepted server 
definitions for use with the Server Template or Server File (-sd) option (see 
page 267). No value is required. Example: 


-ps 


Print Version (-v) 


The -v option displays version and copyright information for RealProducer. 
No value is required: 


-V 


Command Line Usage Examples 


The following sections provide examples of how to run the RealProducer 
command-line application. 


Basic Encoding Examples 
The following examples illustrate the most basic uses of the command-line 
application. 
Simple Encode 


The following example is the simplest possible encoding of a media clip. 
Because no audiences are specified, RealProducer encodes using the default 
audiences described in “Default Audiences and Options” on page 99. Because 
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no output is specified, the encoded clip is named movie.rm. The .rm extension 
is used because the default audiences are constant bit rate audiences: 


producer -i movie.avi 


To save the clip to a different directory or file name, you can include the -o 
option: 


producer -i movie.avi -o c:\videos\movie_streaming.rm 


Variable Bit Rate Encoding 


To encode for any audience other than the default ones, you need to include 
the -ad option. When using a variable bit rate audience, the output uses the 
.rmvb file extension. You can select only one VBR audience per encoding: 


producer -i movie.avi -o movie.rmvb -ad “450k Download” 


Batch Encoding with a Wildcard 


The following example encodes a batch of files using a wildcard to designate 
all MPEG clips in the specified input directory. The output clips are placed in 
the movies directory: 


producer -i C:\source\*.mpeg -o C:\movies\ 


Clip Information 


The following example encodes clip information into the clip: 


producer -i myfile.mov -o output.rm -t "Summer Vacation" -a "John Doe" 
-k "Cape Cod Summer Vacation 2004" 
-de "Video from summer vacation in Cape Cod." 


Job File Examples 


The next set of examples demonstrate how to create and encode with job files. 


Job File Encoding 


The following example shows how to run a job file from the command line. 
The job file specifies the inputs, outputs, and general encoding options. It 
may specify one input and output, parallel inputs, or multiple outputs: 


producer -j GenericStreamingSettings.rpjf 


Job File Creation 


Using the -cj option, you can capture the command line settings to a job file: 
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producer -cj ModemSettings.rpjf -i movie.avi -o movie.rmvb ...additional options... 
Next, you can edit the job file as described in Appendix B if necessary, and run 
it on the command line: 


producer -j ModemSettings.rpjf 


Batch Job File Creation 


If you specify multiple file inputs, as described in “Batch File Encoding” on 
page 252, you can specify an output directory with -cj to create multiple job 
files. For example, you might use the following command: 


producer -cj c:\Jobs\ -i *.avi ...additional options... 
In this case, RealProducer creates a new job file for each AVI file in the current 


directory. The job file for movie1.avi is c:\Jobs\movie1.rpjf, the job file for 
movie2.avi is c:\Jobs\movie2.rpjf, and so on. 


Job File Syntax Update 


RealProducer 10 uses a different job file syntax than Helix Producer. The 
RealProducer 10 graphical user interface and command-line application read 
the older file syntax, but save job files using the new syntax. This new job file 
syntax is not compatible with Helix Producer, so you cannot use a job saved by 
RealProducer 10 with the older Helix Producer. 


You can update existing job files to the new syntax by processing them 
through the command-line application, reading the job with the -j option and 
writing a new job file with the -cj option, as shown in the following example. 
The inputs and outputs specified in the job do not need to be available when 
you run the update: 


producer -j oldjob.rpjf -cj newjob.rpjf 


Note: The command-line application supports the updating of 
a single job file at a time. Batch mode is not currently available. 


Audio Encoding 


The following examples show how to encode audio-only clips. 


RealAudio Lossless 


You can encode an audio or video clip with the RealAudio lossless codec using 
the command-line application only. Use the -ad option to specify the lossless 


audience: 


279 


280 


RealProducer 10 User’s Guide 


producer -i music.wav music.rmvb -ad Lossless 


Voice-Only Clip 
Audio encoding selects music encoding by default. If an audio clip or video 
soundtrack is voice-only, use the -am option to specify voice: 


producer -i lecture.mpeg -am voice ...additional options... 


Audio From a Video 


If you want to encode just the audio portion of a video file, you can use the -dv 
option to disable video: 


producer -i moviel.avi -dv ...additional options... 


Live Capture Examples 


The following examples demonstrate how to capture live input and encode it 
to a file or send it to a server for broadcast. 


Live Input Capture to File 


The following example captures input from the video card and the sound card, 
writing the output to a clip named capturefile.rm: 


producer -vc 0 -ac “Sound Blaster *” -o c:\capturefile.rm 


Live Input Capture for Broadcast 


The following example captures audio and video, delivering the encoded 
stream to Helix Server using the account-based, push method of broadcasting. 
This broadcast method requires a user name (encoder in this example) and 
password: 


producer -v 0 -ac O -sp encoder:as45er897@helixserver.example.com/news.rm 


Capture with Audience Targets 


The following example captures audio and video and streams, sending the 
output to both a server and a file destination. The server broadcast uses the 
password-only push method. The encoding targets the 56k and 150k 


audiences: 


producer -vc 0 -ac 0 -sp TY45poiu@helixserver.example.com/sports/Live.rm 
-o archive.rm -ad "56k,150k" 
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Input Modification Examples 


The next set of examples shows how to modify the input by applying prefilters 
and resizing. 


Prefiltering 


This example applies the audio gain prefilter with a value of 4, applies black- 
level correction and performs auto-detection of de-interlace and inverse- 
telecine: 


producer -i vacation.mov -o vacation.rm -ag 4 -bl -di auto 


Cropping and Resizing 


The next example assumes an input in wide screen format (2.35:1 ratio), with a 
width of 564 pixels and a height of 240 pixels. First, 102 pixels are cropped 
from both the left and right sides to create an input that is 360 by 240 (4:3 
ratio). Then, the video is resized down to approximately 240 by 180 pixels: 


producer -i widescreen.avi -o normal.rm -cr 102,0,320,240 -rs 240x0 
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PART 


FILE FORMATS 


RealProducer uses a set of XML-formatted files to define 
encoding options, audiences, and destinations. The following 
appendixes explain the file syntax so that you can edit the files 
by hand. 


APPENDIX 


A 


XML FILE BASICS 


The text files that RealProducer uses when encoding streams—job 
file, audience file, and server file—use XML (eXtensible Markup 
Language) syntax. This appendix covers the basics of editing these 
files, explaining tags, lists, and namespaces. Subsequent appendixes 


cover the specific syntax for each file type in detail. 


XML File Rules 


This section explains the basics of XML markup, introducing you to the rules 
you need to follow when editing an XML file. If you are familiar with other 
Web-based markup languages, such as HTML, you will pick up XML quickly. 
You need to be careful, though, because XML is less forgiving than HTML. 
Lapses that may not matter in HTML markup, such as missing quotation 
marks or end tags, will prevent an XML file from working properly. 


Tip: You can edit an XML file with any text, HTML, or XML 
editor that can save the file as plain text with the proper 
extension. On Windows, some text editors may automatically 
include .txt as the extension. Disable this feature when saving 
by choosing All Files for Save as type, or change the saved file’s 
.txt extension through the operating system. 


The XML Tag and Namespaces 


XML files begin with an <?xml> version tag: 


<?xml version="1.0" encoding="UTF-8"?> 


Following the version tag, markup consists of one or more elements. An 
audience file, for example, uses an <audience> element that contains all 
additional markup: 
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<?xml version="1.0" encoding="UTF-8"?> 
<audience xmlns="http://ns.real.com/tools/audience.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/audience.2.0 
http://ns.real.com/tools/audience.2.0.xsd"> 
...audience information... 
</audience> 


Each xmlns attribute shown above defines an XML namespace. This namespace 
tells RealProducer how to handle the markup contained within the file. The 
namespace identifier is in the form of a URL only to ensure uniqueness. 
RealProducer does not contact the URL. 


Note: If you edit an XML file, do not change the namespaces. 
When creating a new XML file, be sure to use the appropriate 
namespaces for the file type. 


Tags, Attributes, and Values 


Elements within an XML file take the following form: 
<tag type="type”>value</tag> 
The following are the basic parts to an XML element: 


tag The tag name comes just after a left angle bracket. Some tags may 
consist of just the name, as in the <stream> tag. Other tags may have 
attributes. Except for the XML version tag and the comment tag, all tags 
in an XML file have a corresponding end tag. For example, the 
<audience> tag has the end tag </audience>. 


type The type attributes defines the type of data that the element provides. 
For more information, see “Data Type Values” on page 287. 


value The value is a character string, integer, time value, or so on that defines 
the feature. 


Lowercase or Camel Case for Tags and Attributes 


In RealProducer markup, single-word tags and attributes are lowercase. When 
a tag, attribute, or predefined value consists of a compound word, the first 
letter of all words after the first word is generally capitalized, as in 
encodingComplexity. This is referred to as “camel case.” 
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Attribute Values Enclosed in Double Quotation Marks 


Attribute values, such as string in type="string”, must be enclosed in double 


quotation marks. Do not add any blank spaces between the quotation marks 


and the value they enclose. 


Data Type Values 


Most XML elements within the RealProducer files must include a type 
attribute that indicates the type of value. 


Value Types 

Type Value Notes 

type="bag” group Indicates a group of properties. 

type="bool” true|false True or false values use this type, which stands for 
“Boolean.” You can also use 1 for true and 0 for 
false. 

type="double” decimal A double type is used for very large values, values 

values that include a decimal point, and values that may 

be negative. 

type="duration” |timevalue | A duration type indicates a time value in the format 


{d:][h:][m:]s[.xyz]. 


type="string” text string | A string can include letters and numbers. Do not 
use double quotation marks within the value string. 
Maximum lengths may vary, but are typically at 
least 256 characters 
type="uint” unsigned Values that are positive integers, including 0, use 
integer this type. 
xsi:type="value” | customized | An xsi: prefix allows for customized value types. 
value 


Value Type Examples 


The following examples illustrate the use of the type attribute in RealProducer 


XML files: 


<outputWidth type="uint">360</outputWidth> 


<maxFrameRate type="double">15.000000</maxFrameRate> 


<streamContext type="bag"> 


...stream context elements... 
</streamContext> 
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<stream xsi:type="audioStream"> 
...audio stream elements... 
</stream> 


<deinterlace type="bool">true</deinterlace> 


<pluginName type="string">rn-prefilter-deinterlace</pluginName> 


Duration Syntax 


The format for the value of a parameter that specifies a duration is the 
following: 


({d:][h:][m:]s[.xyz] 


Only the seconds value is required. If a value is omitted, it is assumed to be 
zero. You must specify intermediate values. To indicate hours, for example, 


you must include the minutes and seconds field. Here are some sample values: 


30 30 seconds 

45.5 45-1/2 seconds 

5:35 5 minutes, 35 seconds 
1:0:0 1 hour 


1:22:30:0 1 day, 22 hours, 30 minutes 


File Names and Paths Observe Letter Cases 


In tags that specify files or other input, paths and file names can be uppercase, 
lowercase, or mixed case, corresponding to their actual names on the 


operating system. All of the following path and file name examples are 
allowable, for example: 


<filename type="string">C:\media\video\videol.rm</filename> 
<filename type="string">C:\media\video\Videol.rm</filename> 
<filename type="string">C:\media\video\VIDEO1.rm</filename> 


Note: On operating systems that are not case-sensitive, such as 
Windows, these tags all specify the same file. On a case- 


sensitive operating system such as Linux, these tags indicate 
different files. 


XML Recommendations 


Although not strict rules, the following recommendations will help you keep 
your XML markup organized and understandable. 
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XML Comments 


As in HTML, XML has a comment tag that starts with these characters: 


<!-- 


and ends with these characters: 


--> 


There is no corresponding end tag: 


<!-- This is a comment --> 


A comment can be any number of lines long. It can start and end anywhere in 
a XML file. Multiple comments cannot be nested, though. Use comments to 
describe what various sections of your XML file are meant to do. This helps 
other people understand your file more easily. 


Indentation Between Elements 


Although indenting XML markup is not required, it helps you to keep track of 
the XML file’s structure. You typically indent markup by pressing the Tab key 
once for each level of indentation. In a stream section, for example, the 
element tags are indented one level from the <stream> tag. The two tags that 
make up the stream context are indented one level from the <streamContext> 
tag: 


<stream xsi:type="audioStream"> 
<codecFlavor type="uint">25</codecFlavor> 
<codecName type="string">cook</codecName> 
<encodingComplexity type="string">high</encodingComplexity> 
<pluginName type="string">rn-audiocodec-realaudio</pluginName> 
<streamContext type="bag"> 
<audioMode type="string">voice</audioMode> 
<presentationType type="string">audio-only</presentationType> 
</streamContext> 
</stream> 
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APPENDIX 


B 


JOB FILE SYNTAX 


A RealProducer job file records a range of encoding settings so that 
you can quickly re-encode clips or broadcasts using the same 
properties. This appendix describes the job file syntax. Using this 
information, you can edit a job file without relying on the 


RealProducer graphical application. 


Note: If you are not familiar with XML syntax, refer to 
Appendix A for information about XML namespaces, tags, 
attributes, and values. 


Understanding Job Files 


A job file records the full range of RealProducer settings used to encode a clip 
or broadcast. It defines the audio and video codecs used, for example, and 
specifies the use of filters and other options. When you save a job through the 
graphical application—a process described in Chapter 6—RealProducer 
updates the file automatically to record your encoding changes. You can also 
create job files, which use the file extension .rpjf, through the command-line 
application and edit them manually. This allows you to change job 
information using a text editor or any automated process that can modify 
XML files. 


For More Information: The section “Job File Options” on page 
249 explains how to create a job file through the command- 
line application. 


Features Exclusive to the Job File 


You can set up a few RealProducer encoding features only through a job file or 
command line. The following features are not available through the graphical 
user interface. If your job file includes them, you must encode the jobs using 
the command-line application: 
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« RealAudio Lossless Codec 


To encode audio using the lossless codec, you need to specify the lossless 
codec in an audience definition. The section “Audiences Section” on page 
329 illustrates the audience section in the job file. Appendix C covers the 


audience syntax. 


Multiple Outputs 


A job file can define multiple outputs that are encoded in parallel. 
Multiple outputs might be two separate clips, one of which is encoded for 
a lower bandwidth and resized smaller. For more information, see “File 
and Server Outputs” on page 319. 


Parallel Inputs 


Using a job file, you can merge parallel inputs into a single output. For 
example, you might merge a video stream from a digitized file with audio 
that you capture live. For more information, see “Single and Multiple 
Inputs” on page 299. 


Audio Delay Compensation Prefilter 


This prefilter allows you to resynchronize an audio soundtrack with video. 
This is useful if you are capturing audio and video separately as parallel 
inputs. Refer to “Audio Delay Compensation Prefilter” on page 317. 


Prefilter Resizing 


Through the job file, you can resize the video input before or during the 
encoding. See “Video Resizing Methods” on page 309 for an explanation 
of the available resizing options. 


File Rolling 


File rolling normally occurs when an encoded clip reaches the file size 
limit set by the operating system. With the file rolling parameters, you can 
specify other sizes or time limits for file rolling. See “File Rolling” on page 
322. 


Tips for Creating Job Files 
The following are some tips to keep in mind when using job files: 


- When creating a new job file, RealNetworks recommends that you start 
with an existing job file that you have renamed. RealProducer provides a 
number of predefined job files that are stored in the samples/jobs 
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subdirectory under the RealProducer main directory. You can use these 
files as templates for your own jobs. 


You can override most job file settings through the RealProducer 
graphical application, then save or discard your changes after encoding. If 
a certain clip could benefit from noise filtering, for instance, you can 
apply that filter during the encoding, even though the job file does not 
specify the use of that filter. This gives you the ability to create job files 
with general settings that you change on a case-by-case basis. 


When encoding through the command-line application, you cannot 
override or add to the settings in the job file, except in the specific cases 
described in “Job File Options” on page 249. 


Prefilters, which are described in “Prefilters” on page 307, have parameters 
that enable or disable them. This allows you to define a prefilter within a 
job without activating it. If you think that you may want to use a certain 
prefilter with a job, it’s a good idea to add the prefilter syntax to the job 
file and leave the filter disabled until you need to use it. 


A job can define specific input and output files. You can override a 
specific input and output during encoding. Or, you can create a job file 
that has blank input and output values. If you do this, include the 
appropriate syntax, but leave the value blank, as in the following example: 


<filename type="string"></filename> 


A job file defines encoding audiences, as described in “Audiences Section” 
on page 329. An output’s media profile, described in “Media Profile” on 
page 324, determines which audiences the output uses, though. This 
allows you to define all the audiences you think that you might use within 
the audiences section, then apply those audiences to various outputs 
through their the media profiles. 


RealProducer Plus supports the full range of job file capabilities. If you 
use RealProducer Basic, however, you are limited by the following 
restrictions: 


* no cropping, resize, or audio gain filter 

- RealVideo 10 codec only 

+ maximum of three audiences in a SureStream CBR clip 
* one customized audience 


- one file and one server destination 
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Job Section 


+ no multicast broadcasting 


The <job> and </job> tags encapsulate all job information within a job file. 
The <job> tag follows directly after the XML declaration tag. Be sure to include 
the namespaces shown in the following example, and add any namespaces 
required by customized RealProducer components: 
<?xml version="1.0" encoding="UTF-8"?> 
<job xmlns="http://ns.real.com/tools/job.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/job.2.0 
http://ns.real.com/tools/job.2.0.xsd"> 
...all job parameters... 
</job> 


Job Properties 
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The following table describes the main properties within the <job> list. 


Job Properties 


Property Value Function 

enableTwoPass true|false | Enables two-pass encoding, as described in 

type="bool” “Two-Pass Encoding” on page 78. The default 
is true. This property is ignored for live 
broadcasts. 


disableLoadManagement | true|false | Disables RealProducer’s ability to reduce 
type="bool” encoding complexity during live encodes to 
keep up with the input stream. The default 
value of false should generally not be 
changed. For background, refer to “Broadcast 
Load Management” on page 174. 


clipInfo list Defines clip information, as described in 
“Clip Information” on page 295. 


inputs list Sets the inputs used for encoding the clip or 
broadcast, as described in “Audio and Video 
Inputs” on page 299. 


(Table Page 1 of 2) 
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Job Properties (continued) 


Property Value Function 

parOutputs list Determines the encoding outputs, as 
described in “File and Server Outputs” on 
page 319. 

audiences list Selects the encoding audiences, as described 


in “Audiences Section” on page 329. 
(Table Page 2 of 2) 


Job File Example 


The following abstract example shows the major structure of a job file. The 
order of the lists within the <job> section does not matter. For example, the 
<audiences> list can precede the <clipInfo> list. The hierarchy does matter, 
however. The <audiences> list cannot fall within the <clipInfo> list, for instance: 


<?xml version="1.0" encoding="UTF-8"?> 
<job xmlns="http://ns.real.com/tools/job.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/job.2.0 
http://ns.real.com/tools/job.2.0.xsd"> 
<enableTwoPass type="bool">true</enableTwoPass> 
<clipInfo> 
...clip information such as title, author, and copyright... 
</clipInfo> 
<inputs> 
...inputs used to encode the clip or broadcast contents... 
</inputs> 
<parOutputs> 
...outputs for the encoded content, such as a clip or broadcast server... 
</parOutputs> 
<audiences> 
...audiences for the content, defining bandwidths and the codecs used... 
</audiences> 
</job> 


Clip Information 


The optional clip information section defines metadata properties that are 
encoded into static clips and live broadcasts. The values are typically provided 
for the benefit of the viewer, and do not affect the encoded content. For 
example, a metadata value can provide a clip title that displays in the media 
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player’s title bar. The following abstract example demonstrates clip 
information within the job file structure: 


<clipInfo> 
<entry> 
<name>Metadata Name</name> 
<value type="type”>Metadata Value</value> 
</entry> 
...additional metadata entries... 
</clipInfo> 


Clip Information Values 


Each metadata entry falls between <entry> and </entry> tags. A<name> element 
and <value> element define each metadata property. 


Clip Information Tags 


Tag Value Function 
name | string up to 255 Defines the type of metadata. A media player must 
characters recognize the name to handle the metadata value 


properly. The value cannot be left blank. 


value | integer or string up | Supplies the value for the metadata field. The value can 
to 64 Kilobits be blank. The default is an empty string. 


Metadata Values for RealPlayer 


RealPlayer supports a number of metadata values. If you do not specifically 
add metadata values, no metadata is encoded into the stream. 


Standard Metadata Properties for RealPlayer 


Property Value Function 


Author string up to 255 | Indicates the clip author. 
type="string” | bytes 


Content Rating |integer from 0 | Defines an age range for ratings systems: 
type="uint” to 6 0-No Rating (this is the default) 

1-All Ages 

2-Older Children 

3-Younger Teens 

4-Older Teens (15 and up) 

5-Adult Supervision Recommended 
6-Adults Only 


(Table Page 1 of 2) 
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Standard Metadata Properties for RealPlayer (continued) 


Property Value 


Function 


Copyright string up to 255 
type="string” | bytes 


Provides the clip copyright. 


Description string up to 
type="string” | 1023 bytes 


Gives a clip description that is generally longer 
and more informative than the title. 


Keywords string up to 255 
type="string” | bytes 


Adds keywords for search engines that can read 
RealMedia clips. 


Title string up to 255 
type="string” | bytes 


For More Information: 


Adds a clip title. 


(Table Page 2 of 2) 


The section “Adding Clip Information” 


on page 92 explains the values you should use for the clip 


metadata properties. 


Separate Clip Information for Outputs 


If you define information within a single <clipInfo> list at the start of the job 
file, that information is used for all clips or broadcasts created with the job 
file. As described in the section “File and Server Outputs” on page 319, you 
can also define clip information within each output section. This allows you 
to define separate information for each output when encoding multiple 
outputs. You can also mix the two methods. In this case, clip information 
defined for an output overrides the corresponding information defined for 


the job. 


Tip: You can define the same basic information, such and title, 
author, and copyright for all outputs by setting these values for 
the job. You can then add specific information, such as unique 


descriptions, for each output. 


Clip Information Examples 


The following example defines several metadata properties used for all 
outputs created through the job file: 


<job...> 
<clipInfo> 
<entry> 


<name>Title</name> 


<value type="string”>2003 Football Highlights</value> 
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</entry> 
<entry> 
<name>Copyright</name> 
<value type="string">(C) 2004</value> 
</entry> 
<entry> 
<name>Keywords</name> 
<value type="string">sports, football</value> 
</entry> 
<entry> 
<name>Description</name> 
<value type="string">A year-end review of the highlights in the 2003 
fall football season.</value> 
</entry> 
<entry> 
<name>Content Rating</name> 
<value type="uint">1</value> 
</entry> 
</clipInfo> 
...all other job file information... 
</job> 


The next example defines basic clip information such as title, author, and 
copyright for all outputs, but a separate description for each output. In this 
example, one output is a live broadcast and another output is an archive clip 
that will be available on-demand after the broadcast ends: 


<job...> 
<clipInfo> 
<entry> 
<name>Title</name> 
<value type="string”>2003 Football Highlights</value> 
</entry> 
...other clip info such as author and copyright... 
</clipInfo> 
...other job file information... 
<parOutputs> 
<output> 
...output information for the live broadcast... 
<clipInfo> 
<entry> 
<name>Description</name> 
<value type="string">A live, year-end review of the highlights in 
the 2003 fall football season.</value> 
</entry> 
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</clipInfo> 
</output> 
<output> 
...output information for the archive clip... 
<clipInfo> 
<entry> 
<name>Description</name> 
<value type="string">Archived highlights of the 2003 fall 
football season.</value> 
</entry> 
</clipInfo> 
</output> 
</parOutputs> 
...additional job file information... 
</job> 


Audio and Video Inputs 


The inputs section defines the audio or video input for the job. Inputs can be 
either digitized files or output from capture devices such as cameras attached 
to a video capture card. The <inputs> and </inputs> tags encapsulate the inputs 
section. Within this list, you can define a single input or multiple inputs. 


For More Information: The section “Audio and Video Input 
Formats” on page 25 lists acceptable file and color formats for 
encoding. 


Single and Multiple Inputs 


To define a single input, you add <input> and </input> tags within the <inputs> 
element: 
<inputs> 
<input ...> 
...Single input defined here... 
</input> 
</inputs> 


To define multiple inputs, you add <parInputs> and </parInputs> tags within 
the <inputs> element. Then, you define each input between <input> and 
</input> tags: 
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<inputs> 
<parInputs> 
<input ...> 
...audio input defined here... 
</input> 
<input ...> 
...video input defined here... 
</input> 
</parInputs> 
</inputs> 


Using parallel inputs, you can encode one audio and one video stream 
simultaneously, using any combination of sources. For example, you might 
encode into a single clip the audio from one file and the video from a different 
file. Or, you might combine the audio from a file with video images captured 
live. 


Tip: To encode audio and video from the same live event, you 
capture the audio and video as a single input. You use parallel 
inputs only when the audio and video come from different 
sources. 


Note: When a job includes parallel inputs, you must encode the 
job through the command-line application rather than the 
graphical application. 


For More Information: With parallel inputs, you can use the 
audio delay compensation prefilter to synchronize the audio 
and video inputs. See “Audio Delay Compensation Prefilter” 
on page 317. 


Input Tag 


The <input> tag defines each input. It uses an xsi:type attribute with a value of 
avFileInput or captureInput, respectively, to indicate whether the input comes 
from a digitized file or a capture device. The following example shows a single 
input for a digitized file: 


<inputs> 
<input xsi:type="avFileInput"> 
...input values for the digitized file... 
</input> 
</inputs> 


APPENDIX B: Job File Syntax 


The next example defines the single input as live or prerecorded material 
coming from an audio or video capture device: 
<inputs> 
<input xsi:type="captureInput"> 
...Jnput values for the capture... 
</input> 
</inputs> 


Digitized File Input 


When the input is a digitized file, the input type is avFileInput. You can then 
specify the following properties. You can leave the file name value blank if you 
want to specify the file name through the graphical application, as described 
in “Using a File as the Input” on page 87. The file name value is required when 
you process the job file through the command-line application, however. 


File Input Properties 


Property Value Function 
disableAudio |true|false Disables the audio for all outputs that 
type="bool” use this input when set to true. This 


enables you to capture video only. The 
default is false. You can also disable 
audio output-by-output. See “Media 
Profile Properties” on page 325. 


disableVideo | true|false Disables the video for all outputs that 
type="bool” use this input when set to true. This 
enables you to capture audio only. The 
default is false. You can also disable 
video output-by-output. See “Media 
Profile Properties” on page 325. 


filename file name and path Indicates the path and name of the 

type="string” input file. You cannot use wildcards. 
See “File and Directory Paths” on page 
302. 

name string Assigns a name to the source, such as 

type="string” source1, source2, and so on. This is 


optional, but strongly recommended 
when using parallel inputs. 
(Table Page 1 of 2) 
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File Input Properties (continued) 
Property Value Function 


pluginName |rn-avfile-aviuncompressed | Provides the name of the file system 
type="string” | rn-avfile-directshow plug-in used to read the input file. If 
r-avfile-movuncompressed | You omit this property, RealProducer 
scans available plug-ins and uses the 
first one it finds that can read the 
input format. 


rn-avfile-qt 
rn-avfile-wavuncompressed 


prefilters list of filters Indicates one or more prefilters to use 
with the input. For more information, 
refer to “Prefilters” on page 307. 

(Table Page 2 of 2) 


File and Directory Paths 


For an input’s filename value, you list the path and file name when encoding 
through the command-line interface. When using the graphical application, 
you can specify the name, or leave the value blank and provide the file name 
when encoding. The file name and path should use the standard conventions 
for your operating system. However, RealProducer observes the following 
conventions to help keep the job file portable across platforms: 


- You can specify a relative or absolute path to a file. Relative paths are 
relative to the current working directory, which is the directory from 
which the command-line application is run or the graphical application 
was started. If you start RealProducer by double-clicking a job file, the 
working directory is the directory that holds the job file. 


On Windows, forward slashes in paths are interpreted as backslashes, so 
“7?” is read as “\”. 


On Linux, backslashes are interpreted as forward slashes, so “\” is read as 
ae Aes 


If an absolute path starts with a single slash, RealProducer on Windows 


assumes that the path occurs on the system’s default drive. For example, if 
C:\ is the default drive, the path /home/media/video.mpeg is interpreted as 
C:\home\media\video.mpeg. 


On Linux, absolute paths that start with a drive letter such as C:\ cause an 
error because no logical translation is possible. 
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When the input comes from a capture device, such as a camera, microphone, 


or CD player, the input type is captureInput. You can then specify the following 


properties. Only the capture device ID is required. 


Property 


Capture Input Properties 


Value 


Function 


audioCaptureMono 
type="bool” 


true|false 


Linux only. If set to true, forces capture of 
a single, mono audio channel. Required 
for Linux audio devices not configured as 
stereo pairs. The default value of false 
enables stereo capture. 


audioDevicelD 
type="string” 


integer |string| 
device name 


Sets the audio device used for recording. 
See “Devices and Ports” on page 304 


audioDevicePort 


integer |string| 


Specifies the audio port used for 


type="string” device name recording. You must also provide the 
device ID. See “Devices and Ports” on 
page 304 

duration [d:][h:][m:]s[.xyz] | The length of time to capture from the 


type="duration” 


jinfinite 


device. If no value is used, the default is 
infinite. You can specify down to a 
fraction of a second, but the timing is 
accurate only to the packet size of the 
stream. For audio this is about 200 
milliseconds. For video the size varies 
with the bit rate. For information about 
duration values, see “Duration Syntax” on 
page 288. 


name string Assigns a name to the source, such as 

type="string” source1, source2, and so on. This is 
necessary only if you have multiple inputs 
and multiple outputs. Unique names are 
recommended. 

pluginName rn-capture-av Provides the name of the plug-in used to 

type="string” read the input. If you omit this property, 
RealProducer scans available plug-ins and 
uses the first one it finds that can read 
the input format. 

prefilters list of filters Indicates one or more prefilters to use. 


For more information, refer to “Prefilters” 
on page 307. 
(Table Page 1 of 2) 
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Property 


videoDeviceID 
type="string” 


Capture Input Properties (continued) 


Value 


integer |string| 
device name 


Function 


Sets the video device used for the input. 
See “Devices and Ports” on page 304 


videoDevicePort 
type="string” 


integer |string| 
device name 


Specifies the video port used for the 
input. You must also provide the device 
ID. See “Devices and Ports” on page 304 


videoFormat 
type="string” 


NTSC|NTSC-JP| 
PAL|PAL-M| 

PAL-N|PAL-NC| 
SECAM|integer 


Linux only. Indicates the video format. 
Use one of the predefined strings or an 
integer representing a format understood 
by your driver. On Windows, use the video 
driver dialog to set the video format. The 
default is NTSC. 


videoFrameHeight | integer Sets an optional video height in pixels. 

type="uint” Use any positive integer divisible by 4, and 
not greater than 2048. The default value 
of 0 uses the capture device’s default size. 

videoFrameWidth integer Sets an optional video width in pixels. Use 


type="uint” 


Devices and Ports 


any positive integer divisible by 4, and not 

greater than 2048. The default value of 0 

uses the capture device’s default size. 
(Table Page 2 of 2) 


The required audioDeviceID and videoDeviceID parameters select the capture 


card or cards used for the input. The optional audioDevicePort and 


videoDevicePort parameters set the ports used for audio and video capture, 


respectively. You can use any of the following values: 


+ Integer of value 0 or higher identifying a specific device or port number. A 


value of 0 always selects the first device or port. Here is an example: 


<audioDeviceID type="uint”>1</audioDeviceID> 


examples: 


String matching an existing device or port name. The following are 


<audioDeviceID type="string”>Sound Blaster Live!</audioDeviceID> 
<audioDevicePort type="string”>Line In</audioDevicePort> 


<videoDeviceID type="string”>Osprey Capture Card 1</videoDevicelD> 
<videoDevicePort type="string”>S-Video</videoDevicePort> 


as: 


String with a wildcard (*) matching an existing device or port name, such 


APPENDIX B: Job File Syntax 


<audioDeviceID type="string”>Sound Blaster *</audioDeviceID> 
<audioDevicePort type="string”>Mic*</audioDevicePort> 
<videoDeviceID type="string”>Osprey Capture Card *</videoDevicelD> 
<videoDevicePort type="string”>Composite*</videoDevicePort> 


+ UNIX device name, such as one of the following: 
/dev/audio 
/dev/video 


The following are tips for setting the audio and video device IDs and ports: 


- If you use a single video card to capture both video and audio, you must 
specify both the audioDeviceID and videoDeviceID parameters. 


- Using numbers for the device IDs maximizes the portability of the job file 
so that you can transfer it to another machine. 


- The pull-down lists in the Devices section of the graphical application 
supply the names of audio and video devices on your RealProducer 
computer. For more information, see “Using Live Audio or Video as the 
Input” on page 88. 


+ The command-line application’s -pd option displays audio and video 
device information. See “Print Device Information (-pd)” on page 276. 


+ The video card’s settings define the captured frame rate. During encoding, 
RealProducer uses the largest frame rate among all selected audiences as 
the maximum frame rate target. See “Video Stream Properties” on page 
341. 


Input File and Capture Examples 


The following examples illustrate the syntax for encoding input from files and 
live captures. 


Single Input File 


The following example defines a single input for a digitized file. A single 
prefilter is used with the input. For more on prefilters, refer to “Prefilters” on 
page 307. 
<inputs> 
<input xsi:type="avFileInput"> 
<filename type="string">C:\media\videos\video1.avi</filename> 
<prefilters> 
<prefilter xsi:type="audioGainPrefilter"> 
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<enabled type="bool">true</enabled> 
<gain type="double">-5</gain> 
<pluginName type="string">rn-prefilter-audiogain</pluginName> 
</prefilter> 
</prefilters> 
</input> 
</inputs> 


Single Capture Input 


The following example captures audio and video input for 15 minutes. A 
single prefilter is used to attenuate the audio input. For more on prefilters, 
refer to “Prefilters” on page 307. 


<inputs> 
<input xsi:type="captureInput"> 
<audioDeviceID type="string”>Sound Blaster *1</videoDeviceID> 
<audioDevicePort type="string”>Mic*</videoDevicePort> 
<videoDeviceID type="string”>Osprey Capture Card 1</videoDeviceID> 
<videoDevicePort type="string”>S-Video</videoDevicePort> 
<pluginName type="string”>rn-capture-av</pluginName> 
<duration type="duration">15:00.000</duration> 
<prefilters> 
<prefilter xsi:type="audioGainPrefilter"> 
<enabled type="bool">true</enabled> 
<gain type="double">-5</gain> 
<pluginName type="string">rn-prefilter-audiogain</pluginName> 
</prefilter> 
</prefilters> 
</input> 
</inputs> 


Parallel Inputs 


Using parallel inputs, you can encode one audio stream and one video stream 
from separate sources. The following example captures the visual track from a 
digitized video file. It combines this stream with five minutes of audio from 
the audio capture device. The black-level filter increases the video contrast. 
The audio delay compensation prefilter advances the audio one-half second to 
synchronize it with the video. For more on prefilters, refer to “Prefilters” on 
page 307. 
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<inputs> 
<parInputs> 
<input xsi:type="avFileInput"> 
<name type="string">VideoInput</name> 
<filename type="string">c:\media\promo.avi</filename> 
<disableAudio type="bool">true</disableAudio> 
<prefilters> 
<prefilter xsi:type="blackLevelPrefilter"> 
<pluginName type="string">rn-prefilter-blacklevel</pluginName> 
<enabled type="bool">true</enabled> 
</prefilter> 
</prefilters> 
</input> 
<input xsi:type="captureInput"> 
<name type="string">AudioInput</name> 
<audioDeviceID type="string”>Sound Blaster *1</videoDeviceID> 
<audioDevicePort type="string”>Mic*</videoDevicePort> 
<pluginName type="string”>rn-capture-av</pluginName> 
<duration type="duration">5:00.000</duration> 
<prefilters> 
<prefilter xsi:type="audioDelayCompPrefilter"> 
<pluginName type="string"> 
rn-prefilter-audiodelaycomp</pluginName> 
<enabled type="bool">true</enabled> 
<advance type="double">0.5</advance> 
</prefilter> 
</prefilters> 
</input> 
</parInputs> 
</inputs> 


An optional prefilters section can appear within each <input> list to define the 
audio and video filters that are applied to the input before it is encoded. The 
prefilters appear within a list defined by <prefilters> and </prefilters> tags 
(note the plural “prefilters”). Each prefilter uses <prefilter.../> and </prefilter> 
tags (note the singular “prefilter”) to enclose the prefilter properties. An 
xsi:type attribute within a <prefilter> tag determines the type of prefilter used. 
The following example shows the audio gain prefilter defined within an input 
section: 
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<input xsi:type="avFileInput"> 
...additional input information... 
<prefilters> 
<prefilter xsi:type="audioGainPrefilter"> 
<enabled type="bool">true</enabled> 
<gain type="double">0.000000</gain> 
<pluginName type="string">rn-prefilter-audiogain</pluginName> 
</prefilter> 
</prefilters> 
</input> 


The following table summarizes the available prefilters. 


Available Prefilters 


Prefilter Function Reference 
Cropping Crops out portions of the input video. page 310 
De-interlace and | Removes unnecessary frames from NTSC videos and page 312 
Inverse-Telecine | corrects line shifting in videos more than 240 pixels 

high. 
Video Noise Reduces artifacts in the input video. page 313 
Reduction 
Black Level Improves contrast by making black areas darker and page 314 
Correction light areas whiter. This increases the encoding 

efficiency. 
Resize Resizes the input video and corrects pixel aspect ratios. | page 314 
Audio Gain Amplifies or attenuates the audio signal. page 316 
Audio Delay Corrects audio that is not synchronized with the video. | page 317 
Compensation 


Note: You can also define prefilters within the media profile 
section, which is described in “Media Profile” on page 324. 
This is recommended if you are defining multiple outputs and 
want to use different filters for each output. 


Prefilter Order 


RealProducer applies prefilters in the order they are specified within the job 
file. Because a prefilter alters video data before the data is passed to the next 
filter, specifying prefilters in the wrong order can degrade the output. For 
example, reducing noise can make a video impossible to de-interlace. The 
following is the recommended order for using prefilters on video input: 
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1. Cropping 

. Inverse-Telecine 

. De-interlace 

. Video Noise Reduction 


. Black Level Correction 


NH nA fF WY WN 


. Resize 


Note: You can apply audio prefilters at any point in the 
filtering chain. 


Video Resizing Methods 


The following sections describe the two methods for resizing a video. In either 
case, video resizing during encoding is processor-intensive and should be 
avoided for a live broadcast. If you need to resize a live broadcast, the best 
method is to perform resizing in hardware on the video capture device before 
sending the input to RealProducer. 


Tip: You can also crop an input video to remove unnecessary 
portions. This is done through the cropping prefilter, as 
described in “Input Cropping Prefilter” on page 310. 


Prefilter Resizing 


The video resize prefilter, which is described in “Video Resizing Prefilter” on 
page 314, alters the size of the video before it is encoded. This prefilter is 
useful for correcting non-square pixel aspect ratios. If the input video has a 
non-square pixel aspect ratio (such as DV), you can shorten the video 
horizontally to convert non-square pixels to square pixels. Resizing the video 
before the actual encoding may also speed the rest of the encoding process 
because less source material needs to be encoded. All outputs use the resized 
input. 


Codec Resizing 


Through an output’s media profile, which is described in “Media Profile” on 
page 324, you can also specify a new video height and width. In this resizing 
method, the RealVideo codec resizes the content during the encoding. Because 
codec resizing is more efficient, it is generally preferable to prefilter resizing 
unless you need to correct for non-square pixels. This is the mode used when 
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you resize content through the graphical application or command-line 
application. 


Tip: Always use codec resizing when making a video larger. 
Expanding the video through the resizing prefilter adds extra 
pixels, which makes the clip larger and harder to compress. In 
contrast, resizing the output larger through the codec encodes 
instructions that tell RealPlayer how to increase the video 
dimensions during playback. This keeps the clip size smaller. 


Width and Height Values for Resizing 


For the video resize prefilter, the videoResizeWidth and videoResizeHeight 
properties set the video’s new size. When you resize through the codec, the 
media profile’s outputWidth and outputHeight properties resize the video. Both 
sets of properties work the same way. 


For any resize property, the value must be at least 32, and be a multiple of 4, 

such as 120, 240, 360, and so on. Values not divisible by 4 are rounded down. 
For example, a value of 123 is rounded down to 120. If both height and width 
are set to 0, no resizing occurs. The maximum height or width is 2048 pixels. 


To preserve an input video’s aspect ratio, set the height or width to the desired 
size, then set the other value to 0. If the input video is 640 pixels wide by 480 
high, for example, you can set the width to 320 and the height to 0. This 
automatically scales the height to 240. If you do not preserve the input video’s 
height-to-width ratio when resizing, the output video will appear distorted. 


Input Cropping Prefilter 


The input cropping filter contains several settings for cropping the video 
source. You can use it to cut out unnecessary parts of a video, such as the 
black bars at the top and bottom of a letterboxed, widescreen clip. The 
prefilter uses the type value of xsi:type="inputCroppingPrefilter”. 


Note: The cropping prefilter does not scale the video larger or 
smaller. For information about resizing, see “Video Resizing 
Methods” on page 309. 
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Input Cropping Properties 
The following table describes the cropping properties. 


Input Cropping Prefilter Properties 


Property Value Function 


pluginName |rn-prefilter- | Optionally sets the plug-in to use. If omitted, 
type="string” | inputcropping | RealProducer selects the plug-in based on the 
xsi:type value. 


enabled true|false Enables the filter when set to the default value of 

type="bool” true. 

left integer An integer representing the number of pixels from 
type="uint” the left of the video to start the cropping. You can 


specify up to 32 pixels less than the total width. The 
default is 0. 


width integer An integer indicating the total width of the cropped 
type="uint” video, measured from the value set by the left 
property. The default is the input video width minus 
the pixels cropped by the left property. If the value is 
not a multiple of 4, the next lower multiple is used. 
For example, a value of 162 results in a video 160 
pixels wide. 


top integer An integer representing the number of pixels from 
type="uint” the top of the video to start the cropping. You can 
specify up to 32 pixels less than the total height. The 
default is 0. 


height integer An integer indicating the total height of the cropped 
type="uint” video, measured from the value set by the top 
property. The default is the input video height minus 
the pixels cropped by the top property. If the value is 
not a multiple of 4, the next lower multiple is used. 
For example, a value of 127 results in a video 124 


pixels high. 


Tip: If you perform a horizontal or vertical resizing on the 
video first, the cropping offsets are measured from the video’s 
new size, not its original size. 


Input Cropping Example 


The following example demonstrates the cropping prefilter syntax. Applying 
this prefilter creates a video that is 320 pixels wide by 240 pixels high. The 
output video’s top border begins 12 pixels down from the top border of the 
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input video. As well, its left border begins 24 pixels in from the left border of 


the input video. 


<prefilter xsi:type="inputCroppingPrefilter"> 
<pluginName type="string">rn-prefilter-inputcropping</pluginName> 
<enabled type="bool">true</enabled> 


<left type="uint">24</top> 


<width type="uint">320</top> 


<top type="uint">12</top> 


<height type="uint">240</top> 


</prefilter> 


De-Interlace and Inverse-Telecine Prefilter 


The optional de-interlace filter is useful for videos larger than 240 pixels high. 


The inverse-telecine filter is for NTSC videos that have been transferred from 


film. For an explanation of these filters, refer to “Inverse-Telecine Filter” on 


page 76 and “De-interlace Filter” on page 77. The prefilter uses the type value 


of xsi:type="deinterlacePrefilter”. 


De-Interlace and Inverse-Telecine Properties 


The following table describes the de-interlace and inverse-telecine properties. 


De-Interlace and Inverse-Telecine Prefilter Properties 


Property Value Function 

pluginName rm -prefilter- Optionally sets the plug-in to use. If omitted, 

type="string” deinterlace | RealProducer selects the plug-in based on the 
xsi:type value. 

enabled true|false Enables the filter when set to the default value of 

type="bool” true. 

manual true|false If this property is set to the default of false, 

type="bool” RealProducer applies the de-interlace and inverse- 
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telecine filters only if it determines they are needed. 
This allows you to leave the filter enabled for all 
content and have RealProducer use it only if 
necessary. 

(Table Page 1 of 2) 
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De-Interlace and Inverse-Telecine Prefilter Properties (continued) 


Property Value Function 

deinterlace true|false Applies the de-interlace filter when its value is set to 

type="bool” the default of true. Used only if manual is also set to 
true. 

inverseTelecine | true|false Applies the inverse-telecine filter when its value is 

type="bool” set to the default of true. Used only if manual is also 
set to true. 


(Table Page 2 of 2) 


De-Interlace and Inverse-Telecine Example 


The following syntax provides an example of the de-interlace and inverse 
telecine filters: 
<prefilter xsi:type="deinterlacePrefilter"> 
<pluginName type="string">rn-prefilter-deinterlace</pluginName> 
<enabled type="bool">true</enabled> 
<manual type="bool">false</manual> 
<deinterlace type="bool">true</deinterlace> 
<inverseTelecine type="bool">true</inverseTelecine> 
</prefilter> 


Video Noise Reduction Prefilter 


This filter can reduce video noise. It has high and low settings, which are 
described in the section “Noise Filters” on page 75. The prefilter uses the type 
value of xsi:type="videoNoiseReductionPrefilter”. 


Noise Reduction Properties 


The following table describes the noise reduction filter properties. 


Noise Reduction Prefilter Properties 
Property Value Function 


pluginName rm -prefi lter-video Optionally sets the plug-in to use. If omitted, 
type="string” | Noisereduction RealProducer selects the plug-in based on the 
xsi:type value. 


enabled true|false Enables the filter when set to the default value 
type="bool” of true. 

level low|high Indicates whether to use low or high noise 
type="string” filtering. 
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Noise Reduction Example 


The following is sample syntax for the low noise reduction prefilter: 


<prefilter xsi:type="videoNoiseReductionPrefilter"> 
<pluginName type="string">rn-prefilter-videonoisereduction</pluginName> 
<enabled type="bool">true</enabled> 
<level type="string">low</Level> 

</prefilter> 


Black-Level Prefilter 


This filter increases the video contrast and improves the RealVideo codec 
efficiency. For more information, refer to “Black-Level Correction Filter” on 
page 78. The prefilter uses the type value of xsi:type=blackLevelPrefilter”. 


Black-Level Properties 


The following table describes the black level properties. 


Black-Level Correction Prefilter Properties 


Property Value Function 


pluginName _'n-prefilter-blacklevel | Optionally sets the plug-in to use. If 

type="string” omitted, RealProducer selects the plug-in 
based on the xsi:type value. 

enabled true|false Enables the filter when set to true. 

type="bool” 


Black-Level Example 


The following is sample syntax for the low noise reduction prefilter: 


<prefilter xsi:type="blackLevelPrefilter"> 
<pluginName type="string">rn-prefilter-blacklevel</pluginName> 
<enabled type="bool">true</enabled> 

</prefilter> 


Video Resizing Prefilter 


The video resize prefilter resizes the video input before encoding. You should 
generally run it last, as noted in “Prefilter Order” on page 308, because vertical 
resizing can adversely affect the use of other prefilters. The prefilter uses the 
type value of xsi:type="videoResizePrefilter”. 
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Tip: Refer to “Video Resizing Methods” on page 309 to 


determine if the resize prefilter or codec resizing is the better 


method to use for your content. 


Video Resizing Properties 


The following table describes the video resizing filter properties. 


Video Resizing Prefilter Properties 


Property Value Function 

pluginName rn-prefi lter- Optionally sets the plug-in to use. If 

type="string” videoresize omitted, RealProducer selects the plug-in 
based on the xsi:type value. 

enabled true|false Enables the filter when set to the default 

type="bool” value of true. 

videoResizeWidth integer in Sets the video width in pixels. See “Width 

type="uint” multiples of 4, and Height Values for Resizing” on page 


from 32 to 2048 


310. 


videoResizeHeight 
type="uint” 


integer in 
multiples of 4, 
from 32 to 2048 


Sets the video height in pixels. See “Width 
and Height Values for Resizing” on page 
310. 


videoResizeQuality 
type="string” 


Video Resizing Examples 


fast|high 


Determines the type of resizing to perform 
if the video is resized. The default high 
value results in better quality, but uses 
more CPU. 


The following example demonstrates the video resize filter syntax reducing 


the video size to 176 pixels wide by 132 pixels high: 


<prefilter xsi:type="videoResizePrefilter'> 
<pluginName type="string">rn-prefilter-videoresize</pluginName> 


<enabled type="bool">true</enabled> 


<videoResizeWidth type="uint">176</videoResizeWidth> 
<videoResizeHeight type="uint">13 2</videoResizeHeight> 
<videoResizeQuality type="string">high</videoResizeQuality> 


</prefilter> 


If you are running the de-interlace filter on a large video, you may be able to 


decrease the encoding time by first resizing the video’s width, running the 
g Y g ) g 


other prefilters, then resizing the video’s height. The initial, horizontal resize 


decreases the amount of video data that other prefilters must process. Only 
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vertical resizing needs to be performed after other prefilter operations because 
it can affect de-interlacing. 


The following example resizes a video from 320-by-240 pixels to 176-by-132 
pixels in two steps. Note that in the first resizing, the height is reduced. Here, 
the original width is specified because leaving the videoResizeHeight set to its 
default value automatically reduces the height to keep it in the same aspect 
ratio with the video. In the second resizing, the height is reduced: 


<prefilters> 
<prefilter xsi:type="videoResizePrefilter"> 
<pluginName type="string'>rn-prefilter-videoresize</pluginName> 
<enabled type="bool">true</enabled> 
<videoResizeWidth type="uint">176</videoResizeWidth> 
<videoResizeHeight type="uint">240</videoResizeHeight> 
<videoResizeQuality type="string'>high</videoResizeQuality> 
</prefilter> 
...other prefilters, such as de-interlacing... 
<prefilter xsi:type="videoResizePrefilter"> 
<pluginName type="string'>rn-prefilter-videoresize</pluginName> 
<enabled type="bool">true</enabled> 
<videoResizeWidth type="uint">176</videoResizeWidth> 
<videoResizeHeight type="uint">132</videoResizeHeight> 
<videoResizeQuality type="string'>high</videoResizeQuality> 
</prefilter> 
</prefilters> 


Audio Gain Prefilter 


The audio gain prefilter amplifies or attenuates audio. When the prefilter is 
enabled in the job file, it applies to all audio inputs. The audio gain prefilter 
does not support multichannel audio and should not be used when encoding 
multichannel input. This prefilter uses the type value of 
xsi:type="audioGainPrefilter”. 
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Audio Gain Properties 


The following table describes the audio gain filter properties. 


Audio Gain Prefilter Properties 


Property Value Function 

pluginName rm-prefilter-audiogain Optionally sets the plug-in to use. If 

type="string” omitted, RealProducer selects the plug-in 
based on the xsi:type value. 

enabled true|false Enables the filter when set to the default 

type="bool” value of true. 

gain Number from -48 to _| Sets the audio gain level in dB. Use a minus 

type="double” | 48 sign to indicate negative values. A low value 


effectively mutes the video. High values do 
not introduce clipping. For background, 
refer to “Monitoring Audio” on page 142. 


Audio Gain Example 
The following example demonstrates the audio gain filter syntax: 
<prefilter xsi:type="audioGainPrefilter"> 
<pluginName type="string">rn-prefilter-audiogain</pluginName> 
<enabled type="bool">true</enabled> 
<gain type="double">5.000000</gain> 
</prefilter> 


Audio Delay Compensation Prefilter 


The audio delay compensation prefilter corrects audio shift when audio input 
is out of synchronization with a video’s visual track. It shifts the audio by the 
number of specified seconds, eliminating the need to correct the delay 
through video preprocessing. This is useful when you encode audio and video 
from separate, parallel inputs. 


You can specify this filter only through the job file. It is not available through 
the graphical user interface or command-line application.When the prefilter is 
included in the job file, it applies to all audio inputs. Using this filter, which 
has a type value of xsi:type="audioDelayCompPrefilter”, does not increase the 
encoding time. 


Tip: Some video editing tools, such as DVD ripping software, 
provide information about how much delay exists between 
audio and video. 
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For More Information: For more on separate, parallel inputs 
used to encode audio and video, refer to “Single and Multiple 
Inputs” on page 299. 


Audio Delay Compensation Properties 


The following table describes the audio delay compensation filter properties. 


Audio Delay Compensation Prefilter Properties 


Property Value Function 

pluginName rn-prefi lter- Optionally sets the plug-in to use. If omitted, 

type="string” audiodelaycomp | RealProducer selects the plug-in based on the 
xsi:type value. 

enabled true|false Enables the filter when set to the default value 

type="bool” of true. 

advance time value The time by which to advance the audio 

type="duration” stream if it runs behind the video. For 


information about time values, see “Duration 
Syntax” on page 288. 


delay time value The time by which to delay the audio stream if 

type="duration” it runs ahead of the video. For information 
about time values, see “Duration Syntax” on 
page 288. 


Note: You typically specify either advance or delay. If you specify 
both, the applied delay value is the difference between the two 
values. For example, if you set advance to 0.2 seconds and delay 
to 0.5 seconds, the applied audio compensation is a delay of 0.3 
seconds. 


Audio Delay Compensation Example 
The following example demonstrates the audio gain filter syntax: 
<prefilter xsi:type="audioDelayCompPrefilter"> 
<pluginName type="string">rn-prefilter-audiodelaycomp</pluginName> 
<enabled type="bool">true</enabled> 
<delay type="duration">0.1</delay> 
</prefilter> 
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File and Server Outputs 


The outputs section defines the output for the job, which is either an encoded 
clip or a broadcast stream sent to Helix Server. The <parOutputs> and 
</parOutputs> tags encapsulate the outputs section. Within this list you can 
define one or more outputs between <output> and </output> tags. All outputs 
defined in this section are encoded simultaneously when the job file runs. 


The <output> tag defines each output within the <parOutputs> list. An <output> 
section is itself a container for separate sublists that define the output’s 
destination, media profile, and optional clip information. The following 
example shows the structure for defining a single output for a digitized file: 


<parOutputs> 
<output> 
<destinations> 
...output destinations for the clip or broadcast... 
</destinations> 
<mediaProfile> 
...profile for the output, such as the audiences it uses... 
</mediaProfile> 
<clipInfo> 
...optional clip information for the output... 
</clipInfo> 
</output> 
...additional outputs... 
</parOutputs> 


Note: When you define more than one output, the output 
streams are encoded simultaneously. You must use the 
command-line application to process a job file that includes 
multiple outputs, however. For live captures, it is important 
that your RealProducer machine has sufficient processing 
power for parallel outputs. 


For More Information: For instructions about defining clip 
information for each output, refer to “Clip Information” on 
page 295. For background on broadcast requirements, refer to 
Chapter 10. 
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Destinations Section 
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The destinations section defines the destination for each output, which can 
either be a clip or a broadcast stream sent to a server. The <destinations> and 
</destinations> tags encapsulate the destinations section within an <output> 
list. Within this list you can define one or more destinations between 
<destination> and </destination> tags. All destinations defined for the output 
are encoded simultaneously when the job file runs. 


Destination Tag 


A <destination> tag defines each destination within the <destinations> list. It 
uses a type attribute with one of the following values to encode the output as a 
file or a broadcast stream: 


xsi:type="fileDestination” Encodeas a file. 


xsi:type="pushServer” Encode a broadcast stream that is pushed to a server. 

xsi:type="pullServer” Encode a broadcast stream that is pulled by a server. 

xsi:type="g2PushServer” Encode a broadcast stream that is pushed to a legacy 
server. 


File Destinations 


When the output destination is a digitized file, the destination type is 
xsi:type="fileDestination”. You can then specify the properties described in the 
following table. A file name parameter is required, but you can leave the value 
blank if you want to specify the name through the graphical application, as 
described in “Creating a Destination Clip” on page 90. When you use the 
command-line application, you must include the file name. If you specify 
more than one output file, you must run the job through the command-line 
application. 


File Output Properties 


Property Value Function 

destinationRollSize | integer Sets the size in Megabytes at which to 

type="uint” create a new output clip. See “File 
Rolling” on page 322. 

destinationRollTime | time value Sets the time at which to create a new 

type="duration” output clip. See “File Rolling” on page 
322. 


(Table Page 1 of 2) 
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File Output Properties (continued) 


Property Value Function 
filename file name and path | Indicates the path and name of the out 
type="string” file. You cannot use wildcards. See 


“Output File Names” on page 321. 


name string Assigns a handle to the output. This is 
type="string” not related to the file name and is 
typically used only by graphical 
applications to identify the output. 


pluginName m-file-realmedia Provides the name of the file system 

type="string” plug-in that writes the file. Required 
only if you are not created a RealMedia 
clip. 


(Table Page 2 of 2) 


File Destination Example 
The following example shows a single input for a digitized file: 


<destination xsi:type="fileDestination"> 
<filename type="string">C:\media\movie.rm</filename> 
</destination> 


Output File Names 


An output file name is required when encoding through the command-line 
application. It is optional when using the graphical application, however, and 
you can add the name through the graphical application before you encode, as 
described in “Creating a Destination Clip” on page 90. 


Whether you use the command-line application or graphical application, you 
can omit the file name value as long as you encode from an input file. The 
output then uses the same base file name as the input, along with the 
appropriate extension (.rm or .rmvb). For example, a constant bit rate clip 
encoded from movie.avi becomes movie.rm. A variable bit rate version becomes 
movie.rmvb. 


If you specify the name of clip that exists already in the output directory, 
RealProducer archives the existing clip by appending _archNNN to the base file 
name. Hence, movie.rm becomes movie_arch001.rm before the new movie.rm clip 
is saved. If you encode the output again, the existing movie.rm becomes 
movie_arch002.rm. Higher numbers therefore represent newer archives. 


321 


RealProducer 10 User’s Guide 


322 


File Rolling 


File rolling allows you to create multiple RealMedia files for a single output 
clip. Each new file is appended with a number. The output clip movie.rm might 
be saved as movie.rm, movie1.rm, movie2.rm, and so on. Rolling happens 
automatically when the clip reaches the RealMedia file format limit (4 GB), or 
the maximum size allowed by the operating system: 


- 2 or 4 Gigabytes on Windows 
- 2 Gigabytes on Linux 


You can also specify limits to the file size using the destinationRollSize 
property. A value of 30, for example, creates a new output clip from the file or 
live input when the current clip reaches 30 Megabytes in size. 


Rolling Files By Time 

The destinationRollTime property rolls new files based on the amount of time 
that RealProducer has encoded the output. For example, if you set a file 
destination time of 15 minutes when encoding a broadcast named live.rm, the 
first 15 minutes is encoded as live.rm, the second 15 minutes is saved as 
livel.rm, and so on. 


Because this time-rolling method is based on encoding time rather than the 
input media’s timeline, it can produce clips of various lengths when you 
encode an input file. With a roll time of 15 minutes, each rolled clip may play 
for 20 minutes, for example, if RealProducer was able to encode the input 
faster than real-time. 


Time values are accurate to the minute, but should include a seconds 
designation using the syntax described in “Duration Syntax” on page 288. For 
example, the following sets a roll time of 10 minutes: 


<destinationRollTime type="duration”>10:00</destinationRollTime> 


Tip: You can specify both a file rolling time and a file rolling 
size. In this case, the new file is created when the first specified 
limit is reached. 


Combining Archives 

Using the RealMedia Editor described in Chapter 12, you can combine rolled 
files into a single output, up to the file size limit of your operating system. 
You can also play the individual clips in sequence through a Ram file ora 
SMIL file. With either method, though, that file transitions may not be 
seamless, and may contain audio and video gaps. If you stream the clips in 
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sequence, each new clip may require buffering that temporary pauses playback 
on RealPlayer. 


Tip: Refer to Introduction to Streaming Media or RealNetworks 
Production Guide for information about combining rolled clips 
into a single sequence using a Ram file or a SMIL file. 


Server Destinations 


When the output destination is a server, the destination type is one of the 
following, depending on the server type and the broadcast method: 


xsi:type="pushServer” Encodes a broadcast stream that is pushed to a server. 
For background, refer to the push broadcasting sections 
of Chapter 11. The section “Push Server Syntax” on 
page 346 explains the markup for this broadcast type. 


xsi:type="g2PushServer” Pushes a broadcast stream to a legacy server. For 
background, refer to “Setting up a Legacy Broadcast” on 
page 199. The section “Legacy Push Server Syntax” on 
page 351 explains the markup for this broadcast type. 


xsi:type="pullServer” Creates a broadcast stream that is pulled by a server. For 
background, refer to “Running a Pull Broadcast” on 
page 202. The section “Pull Server Syntax” on page 353 
explains the markup for this broadcast type. 


If you plan to encode using the graphical application, you can include the 
server destinations in the job file. Or, you can leave the server destination 
section empty, and define server destinations through the graphical 
application as described in Chapter 11. When you broadcast using the 
command-line application and a job file, your job file must define the server 
destination. 


Tip: The easiest way to define a server destination is to create a 
a server file as described in Appendix D. Then, incorporate the 
server file syntax into the job file. 


Incorporating a Server File into a Job File 


You can add server destination information from a server file into a job file 
manually, as described in the following procedure. 
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» To create a job file server destination from a server file: 


1. Create a <destinations>...</destinations> section for the output if one does 
not exist already. 


2. Copy everything from the selected server file between its <destination> and 
</destination> tags, and paste this markup into the <destinations> element. 
This is everything in the server file, except for the XML declaration tag on 
the first line. 


3. Delete the namespaces from the <destination> tag. The job file requires 
only the namespaces defined in the <job> tag. 


4. If you wish to use the job file in the graphical application, include the 
server’s name property. 


5. If you set up multiple broadcast outputs sent to the same server, ensure 
that each stream name, as defined by the streamname property, is unique. 


Media Profile 
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Within an output section, a media profile section defines the output settings, 
such as which audiences are used. Because you define the media profile 
separately for each output, you can create multiple outputs that have different 
properties, such as two clips encoded at different dimensions. A list created by 
the <mediaProfile> and </mediaProfile> tags defines these settings between each 
output’s <output> and </output> tags, as shown in the following example: 


<parOutputs> 
<output> 
...output information... 
<mediaProfile> 
...media profile settings for this output... 
</mediaProfile> 
</outputs> 
<parOutputs> 


Media Profile Properties 


APPENDIX B: Job File Syntax 


The following table describes the properties defined in an output’s media 


profile section. The audience references section is required. All other elements 


are optional. 


Property 


Media Profile Properties 


Value 


Function 


audienceRefs 


list 


Indicates the audiences to use when 
encoding the output. See “Media 
Profile Audience References” on page 
326. 


audioMode 
type="string” 


voice|music 


Describes the type of audio content. 
The default is music. The chosen 
audiences should have an audio 
stream that corresponds to this 
setting, whether the clip is audio-only 
or audio-video. See “Audio Stream 
Context” on page 336. 


audioResamplingQuality 
type="string” 


fast|high 


Affects the quality of audio 
resampling, which must be done if the 
codec sample rate differs from the 
input sample rate. The default high 
resampling results in better quality, 
but uses more CPU. With either value, 
there is no pitch shift. For 
background, refer to “Sampling Rate” 
on page 36. 


disableAudio 
type="bool” 


true|false 


Disables the audio output if set to 
true. The default is false. You can also 
disable the audio for each input, as 
described in “Digitized File Input” on 
page 301. 


disableVideo 
type="bool” 


true|false 


Disables the video output if set to 
true. The default is false. You can also 
disable the video for each input, as 
described in “Digitized File Input” on 
page 301. 


outputHeight 
type="uint” 


integer in 
multiples of 4, 
from 32 to 2048 


Sets the video height in pixels. See 
“Width and Height Values for 
Resizing” on page 310. 

(Table Page 1 of 2) 
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Media Profile Properties (continued) 


Property Value Function 
outputWidth integer in Sets the video width in pixels. See 
type="uint” multiples of 4, “Width and Height Values for 


from 32 to 2048 | Resizing” on page 310. 


prefilters list of filters Indicates one or more prefilters to use 
with the input. You can also define 
prefilters in the inputs section to 
apply the same filters to all outputs. 
For more information, refer to 
“Prefilters” on page 307. 


resizeQuality fast|high Determines the type of resizing to 
type="string” perform if the video is resized. The 
default high value results in better 
quality, but uses more CPU. 


videoMode sharp|normal| Sets the video mode. This setting is 
type="string” smooth|slideshow ignored for quality-based VBR 
encoding. The default is normal. For 
background, refer to “Choosing Video 
Options” on page 97. 

(Table Page 2 of 2) 


Media Profile Audience References 


The <audienceRefs> list contains one or more <audienceRef> elements that 
select which audiences are used with the output. The audience defines the 
audio and video codecs used, and sets the output’s streaming bandwidth. The 
audiences are defined elsewhere in the job file, as described in “Audiences 
Section” on page 329. The value enclosed by the <audienceRef> element must 
correspond to an audience name, which is described in “Audience Properties” 
on page 333. 


Multiple Audience References Example 
The following example shows four audiences used when encoding an output: 


<parOutputs> 
<output> 
...output information... 
<mediaProfile> 
...media profile information... 
<audienceRefs> 
<audienceRef>16k Substream for 28k Dial-up</audienceRef> 
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<audienceRef>28k Dial-up</audienceRef> 
<audienceRef>56k Dial-up</audienceRef> 
<audienceRef>256k DSL or Cable</audienceRef> 
</audienceRefs> 
</mediaProfile> 
</output> 
</parOutputs> 


Combining Multiple Audiences 


As shown in the preceding example, you can encode multiple streams into a 
single output using SureStream. When you do this, you must choose 
audiences appropriately for the encoding to work: 


- Using more than one audience requires that all audiences use constant bit 
rate encoding. Attempting to include a variable bit rate stream in the 
output causes the encoding to fail. In each audience definition, the 
encodingType value should be cbr. For more information, refer to “Video 
Stream Properties” on page 341. 


All video streams must use the same video codec. You cannot encode some 
streams as RealVideo 10 and some streams as RealVideo 8, for example. If 
audiences specify different RealVideo codecs, the newer codec is used. For 
information on selecting the video codec, see “Video Stream Properties” 


on page 341. 


- To make good use of SureStream, streams should use significantly 
different bandwidths, as determined by the audience’s avgBitrate element: 


- If two video streams have average bit rates within five percent of each 
other, RealProducer encodes both streams but logs a warning. 


- If two or more audio streams use different audio codecs that differ in 
bit rate by 1 Kbps or less, RealProducer logs an error and stops the 
encoding. Difference audiences can specify the same audio codec, 
however. To conserve file size and processing time, RealProducer 
encodes the audio stream only once. 


For More Information: For more on avgBitrate, see “Audience 
>) 


Properties” on page 333. 


Media Profile Example 


The following example shows media profile settings defined for two output 
clips. The first clip is meant for dial-up modem connections, so it specifies 


327 


RealProducer 10 User’s Guide 


dial-up modem audiences, and resizes the input to make it smaller. This helps 
to increase the frame rate and clarity when streaming over slow connections. 

The second output is for broadband connections. It specifies several DSL and 
cable modem audiences, keeping the encoded video the same size as the input: 


<parOutputs> 
<output> 
...output information for the first file... 
<mediaProfile> 
<audioMode type="string">voice</audioMode> 
<disableAudio type="bool">false</disableAudio> 
<disableVideo type="bool">false</disableVideo> 
<outputHeight type="uint">13 2</outputHeight> 
<outputWidth type="uint">176</outputWidth> 
<resizeQuality type="string">high</resizeQuality> 
<audienceRefs> 
<audienceRef>16k Substream for 28k Dial-up</audienceRef> 
<audienceRef>28k Dial-up</audienceRef> 
<audienceRef>56k Dial-up</audienceRef> 
</audienceRefs> 
</mediaProfile> 
</output> 
<output> 
...output information for the second file... 
<mediaProfile> 
<audioMode type="string">voice</audioMode> 
<disableAudio type="bool">false</disableAudio> 
<disableVideo type="bool">false</disableVideo> 
<outputHeight type="uint">0</outputHeight> 
<outputWidth type="uint">0</outputWidth> 
<resizeQuality type="string">high</resizeQuality> 
<audienceRefs> 
<audienceRef>256k DSL or Cable</audienceRef> 
<audienceRef>512k DSL or Cable</audienceRef> 
<audienceRef>768k DSL or Cable</audienceRef> 
</audienceRefs> 
</mediaProfile> 
</output> 
</parOutput> 


For More Information: For information about the relationship 
between video dimensions, bandwidth, and output quality, see 
“Factors for Creating a Good Streaming Video” on page 53. 
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Audiences Section 


The audiences section defines one or more audiences that are used within the 
job file. Because a job file can define multiple audiences, the audience section 
starts and ends with <audiences> and </audiences> tags (note the plural 
“audiences”). Within this section, one or more sublists defined between 
<audience> and </audience> tags (note the singular “audience”) create each 
audience setting. The following example shows the structure of the audience 
section within a job file: 


<job...> 
...additional job file information... 
<audiences> 
<audience> 
...first audience definition... 
</audience> 
<audience> 
...second audience definition... 
</audience> 
...additional audience definitions... 
</audiences> 


</job> 
For More Information: Refer to Appendix C for an explanation of 
the audience syntax. 

Working with Audiences 


Each job file should have an audiences section defined between <audiences> 
and </audiences> tags. If you plan to encode using the graphical application, 
you can include the audiences in the job file. Or, you can leave the audiences 
section empty, and select your audiences through the graphical application as 
described in “Choosing Audiences” on page 98. 


When you use a job file with the command-line application, your job file must 
define the audiences. The easiest way to create the audience definitions is to 
import the syntax from an audience file, as described in “Incorporating an 
Audience File into a Job File” on page 330. 


It’s important to keep in mind that not every audience listed in the job file 
must be used when encoding. The audience definitions within the <audiences> 
list provide the reference information necessary to encode for a particular 
audience. An output’s media profile section determines which audiences are 
used for that output, however, as described in “Media Profile” on page 324. 
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Incorporating an Audience File into a Job File 


You can add audience information from an audience file into a job file 


manually, as described in the following procedure. 


> To create a job file audience section from an audience file: 


1, 


Create an <audiences>...</audiences> section within the job file if one does 
not exist already. This list falls within the <job>...</job> list, and typically 
appears at the end of the job file. Note the plural “audiences” in the tag 
names. 


. Copy everything from the selected audience file between the <audience> 


and </audience> tags. This is everything in the file, except for the XML 
declaration tag on the first line. 


. Delete the namespaces from the <audience> tag. The job file requires only 


the namespaces defined in the <job> tag. 


. Ensure that the audience definition includes a name attribute, which is 


described in “Audience Properties” on page 333. 


. For each output in the job file that uses these audience settings, modify 


the output’s media profile to refer to the audience by way of the audience 
name value. For more information, refer to “Media Profile Audience 
References” on page 326. 


APPENDIX 


C 


AUDIENCE FILE SYNTAX 


This appendix describes the RealProducer audience syntax. Each 
audience file or job file records settings about how clips and 
broadcasts are encoded. The information in this appendix allows 
you to edit audience information to modify encoding settings 


without using the RealProducer graphical application. 


Note: If you are not familiar with XML syntax, refer to 
Appendix A for information about XML namespaces, tags, 
attributes, and values. 


Understanding Audiences 


Each audience section within an audience file or job file defines a single 
audience for which a clip or broadcast is encoded. RealProducer predefines a 
number of audiences that appear within the graphical user interface when you 
click the Audiences button. For example, one audience is for 56 Kbps dial-up 
modems while another is for 256 Kbps DSL and cable modem users. Each 
audience specifies the streaming rates at which audio and video clips are 
encoded, along with other settings. 


Audience Files 


The audience files are stored in the audiences subdirectory under the main 
RealProducer installation directory, although you can change this location 
through the RealProducer preferences. Audience files use the file extension 
.rpad, and their file names correspond directly to the audience name in the 
graphical application. For example, the 56k Dial-up audience in the graphical 
user interface stores its information in the file named 56k Dial-up.rpad. 


If you edit an audience through the graphical application—a process described 
in “Creating and Editing Audiences” on page 153—RealProducer updates the 
corresponding audience file to record the changes. You can also edit audience 
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files manually. This allows you to change audience information used by the 
graphical application or command-line application using a text editor or any 
automated process that can modify text files. 


Tip: When creating a new audience file, RealNetworks 
recommends that you start with an existing audience file that 
you have renamed. 


Audiences in Job Files 


A job file, which Appendix B explains, can also hold information about 
audiences. For example, if you use the RealProducer graphical application to 
create a new job and add the 56k Dial-up audience to this job, RealProducer 
copies the audience information from the 56k Dial-up.rpad audience file into 
the job file. Unlike an audience file, which defines just a single audience, a job 
file can define multiple audiences. This is necessary for using SureStream 
technology, which encodes a single clip with multiple streams targeting 
different audiences. 


When you encode a clip using a job file, RealProducer gathers the audience 
information from the job file, rather than the original audience file. This 
allows you to change the audience settings for the job without affecting the 
audience default settings. For instance, you might change an audio codec used 
for your 56 Kbps dial-up audience within a job. That change affects only the 
clips encoded using that job file. 


The syntax for defining an audience within an audience file and a job file is 
the same, except for the following differences: 


- The main <audience> tag in an audience file requires a namespace, whereas 
an <audience> tag within a job file does not use a namespace. 


Within a job file, an audience definition requires a name value. A job 
allows multiple outputs, such as encoding to two separate files. Using the 
name values, you can specify which audiences each output uses. One 
output might use a high-bandwidth audience, for example, while another 
output encodes for a low-bandwidth audience. 


Because a job file supports multiple audiences, each <audience> section 
falls within a list that begins with an <audiences> tag and ends with 
</audiences>. The audience file, which defines only one audience, does not 


use the <audiences> container list. 


APPENDIX C: Audience File Syntax 


For More Information: Refer to “Audiences Section” on page 329 
for an explanation of how audiences appear within a job file. 


Audience Section 


The <audience> and </audience> tags encapsulate an audience section within 
an audience file or job file. The audience section then uses separate <streams> 
sections to define the video stream, the audio stream, and so on. For a 
standalone audience file that defines a single audience, the <audience> tag 
follows directly after the XML declaration tag. Be sure to include the 
namespaces shown in the following example, and add any namespaces 
required by customized RealProducer components: 
<?xml version="1.0" encoding="UTF-8"?> 
<audience xmlns="http://ns.real.com/tools/audience.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/audience.2.0 
http://ns.real.com/tools/audience.2.0.xsd"> 
...all audience parameters... 
</audience> 


For More Information: For information about defining an 
audience within a job file, refer to “Audiences Section” on page 
329. 


Audience Properties 


The following table describes the properties of an <audience> element. 


Audience Properties 
Property Value Function 


avgBitrate positive integer Defines the average bit rate for this audience in 
type="uint” | from 1 to 999999 | bits per second (bps). This is ignored if the 
encoding type is set to vbrQuality, or you are 
encoding audio without video. For more on 
encoding types, refer to “Stream Encoding 
Types” on page 342. 


(Table Page 1 of 2) 
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Audience Properties (continued) 


Property Value Function 


maxBitrate positive integer Limits the total bit rate for this audience to a 
type="uint” | from 1 to 999999 | maximum number in bits per second (bps). The 
value, which must be more than the value for 
avgBitrate, applies only if the encoding type is 
vbrBitrate or vbrQuality, as described in “Stream 
Encoding Types” on page 342. 


name string Creates a user-defined name that identifies the 
type="string” audience template. This name appears in the 
graphical user interface. The job file uses the 
name to determine which audiences each 
output uses. 


streams list Defines each stream in the audience, as 
described in “Streams Section” on page 334. 
(Table Page 2 of 2) 


Audience Properties Example 


The following example shows a template for an audience using 256 Kbps DSL 
or cable modem connections. The average bit rate is set to 225 Kbps, which 
allows approximately 10 percent of the total bandwidth for network overhead. 
If variable bit rate encoding is used, bandwidth spikes can reach 450 Kbps: 


<audience> 
<avgBitrate type="uint">225000</avgBitrate> 
<maxBitrate type="uint">450000</maxBitrate> 
<name type="string">256k DSL or cable</name> 
<streams> 

...streams defined here... 

</streams> 

</audience> 


Streams Section 
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Each audience template has a streams section that defines the encoded 
streams. This section starts and ends with <streams> and </streams> tags (note 
the plural “streams”). Within this list, one or more sublists defined between 
<stream> and </stream> tags (note the singular “stream”) define each stream 
setting. 


Each <stream> section can define an audio or video stream. All stream types are 
optional. You can omit the video stream from audio-only encodings, for 


APPENDIX C: Audience File Syntax 


example. You define each video stream once within the audience section. For 


audio, however, you can define up to four streams for four separate audio 


contexts: 


music in an audio-only clip 
voice in an audio-only clip 
music in a video clip 


voice in a video clip 


The various <stream> sections use an xsi:type attribute to indicate the type of 


the stream. The following example shows the five possible streams defined 


within an audience section: 


<audience> 
...other audience properties... 
<streams> 


<stream xsi:type="audioStream"> 

...audio stream for music in an audio-only clip... 
</stream> 
<stream xsi:type="audioStream"> 

...audio stream for voice in an audio-only clip... 
</stream> 
<stream xsi:type="audioStream"> 

...audio stream for music in a video clip... 
</stream> 
<stream xsi:type="audioStream"> 

...audio stream for voice in a video clip... 
</stream> 
<stream xsi:type="videoStream"> 

...video stream... 
</stream> 


</streams> 
</audience> 


Audio Stream Properties 


The following table describes the properties that the various audio streams 


can contain. Each audio stream section begins with a <stream 
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xsi:type="audioStream"> tag and ends with a</stream> tag. The codecName and 
codecFlavor properties are required. 


Audio Stream Properties 


Property Value Function 
codecFlavor number Sets the encoding speed used with the 
type="uint” chosen codec. For a list of the flavor 


numbers, refer to the tables in the 
section “RealAudio Codecs” on page 35. 


codecName sipr|cook|ralf|raac | Defines the type of codec used to encode 
type="string” the stream. For a list of the codec names, 
refer to the tables in the section 
“RealAudio Codecs” on page 35. 


encodingComplexity | low|medium|high | Sets the complexity for the lossless codec, 
type="string” as described in “Encoding Complexity 
Modes” on page 79. This value is ignored 
for all other codecs. The default is high. 


encodingType cbr| Determines the encoding type. The 
type="string” vbrUnconstrained | default is vbrUnconstrainedQuality for 
Quality the RealAudio lossless codec, cbr for all 


other codecs. Omit this to choose the 
encoding type automatically. For 
background, refer to “Stream Encoding 
Types” on page 342. 


pluginName rm-audiocodec- Optionally sets the plug-in to use. If 
type="string” realaudio| omitted, RealProducer selects the plug-in 
rn-audiocodec- based on the xsi:type value. 
lossless 
streamContext list Determines the audio context for which 
type="bag” the codec is used. Refer to “Audio Stream 


Context” on page 336. 


Audio Stream Context 


Each audience can have up to four audio streams that define which audio 
codec is used based on the presentation type (audio-only or audio-video) and 
audio mode (voice or music). This creates four possible audio stream contexts: 


+ voice in an audio-only clip 
* music in an audio-only clip 


+ voice in a video clip 
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* music in a video clip 


These contexts exist because you should use different codecs when encoding 
music or voice. As well, the audio typically receives more bandwidth in an 
audio-only clip than in a video clip. When RealProducer encodes a clip using 
the audience information, it selects just one of the audio contexts, based on 
other audio settings you have defined in the job file, graphical application, or 
command line. 


For More Information: For background on audio contexts, refer 
to the section “Audio Encoding for Audiences” on page 103. 


Stream Context Element 


Each audio stream uses the streamContext sublist to define one of the four 
possible audio contexts. For example, the following markup instructs 
RealProducer to use this audio stream when encoding voice audio for a video 
clip or broadcast: 


<stream xsi:type="audioStream"> 
...audio codec information... 
<streamContext type="bag"> 
<audioMode type="string">voice</audioMode> 
<presentationlype type="string'">audio-video</presentationType> 
</streamContext> 
</stream> 


Stream Context Properties 


The following table describes the stream context properties. 


Stream Context Properties 


Property Value Function 
audioMode music|voice | Indicates that the audio is music or voice, causing 
type="string” RealProducer to encode with a music or voice 


codec. The default is music. 


presentationType | audio-video| | Specifies if the stream is audio and video, or 
type="string” audio-only _| audio-only. If audio-only is selected, RealProducer 
generally uses a higher bit-rate codec for the 
audio. The default is audio-video. 


For More Information: The section “Setting Audio Parameters” 
on page 96 explains how to set the audio mode through the 
graphical application. For the command line, see the section 
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“Audio Mode (-am)” on page 271. See “Media Profile” on page 
324 for information about how the stream context is set ina 
job file. 


Using Fewer than Four Audio Stream Contexts 


Unless you are an advanced user, RealNetworks recommends that you always 

define four separate audio streams for the four possible stream contexts. This 
ensures that the audience information is valid for all possible audio contexts. 
However, you can define fewer than four audience contexts depending on your 
encoding needs. Improperly defining these audio contexts, however, may cause 


errors. 


If you encode only music videos, for example, you can define just one audio 
stream that uses the appropriate music codec for your audience streaming 
speed. In this case, you do not need to include a <streamContext> list. 
RealProducer uses the single, defined stream for any audio encoded for the 


audience. 


If you define a single audio stream, though, you may inadvertently create 
unstreamable clips, or clips that do not use available bandwidth effectively. 
Suppose that you create a 56 Kbps modem audience and use a 32 Kbps music 
codec as the only audio stream. The total streaming speed for this audience is 
approximately 34 Kbps. As long as you encode audio-only files, you are using 
bandwidth effectively. But if you encode a video with this audience setting, the 
visual track gets only 2 Kbps of bandwidth, rendering the video useless. 


Conversely, you might define a 6 Kbps music clip for your 56 Kbps modem 
audience. This leaves about 28 Kbps of usable bandwidth for a video’s visual 
track, which is a good division. However, if you encode an audio-only clip with 
this audience, it still uses just 6 Kbps of the bandwidth for the audio, letting 
the other 28 Kbps of bandwidth go unused. For an audio-only clip, you want 
to select a higher-bandwidth codec that uses bandwidth more effectively and 
improves the sound quality. 


When you define multiple audio streams for different stream contexts, you 
need to ensure that a context fits your audio encoding settings. Suppose that 
you set RealProducer to encode a video sound track with music, and your 
audience file specifies just two streams: 


+ a stream for audio-only music 


+ a stream for audio-only voice 
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In this case, RealProducer does not encode the clip because no context for 
audio-video with music exists. 


Audio Context Examples 


The following sections explain the codec choices and show the markup used 
for defining audio streams for a 56 Kbps dial-up modem audience. Because 
this type of modem connection rarely achieves a sustained throughput of 56 
Kbps, the avgBitrate value for the audience is set at 34 Kbps. The audio (or 
audio and video together) cannot use more than this amount of bandwidth. 


For More Information: The section “RealAudio Codecs” on page 
35 lists the audio codecs along with the values you use for 
codecName and codecFlavor. 


Voice for Audio-Only Clips 


For audio-only with voice, choose a voice codec that uses as much of the 
available bandwidth as possible. For a 34 Kbps target speed, for example, the 
best choice is 32 Kbps voice, which has a codec name of cook and a flavor of 7: 


<stream xsi:type="audioStream"> 
<pluginName type="string">rn-audiocodec-realaudio</pluginName> 
<codecName type="string">cook</codecName> 
<codecFlavor type="uint">7</codecFlavor> 
<encodingComplexity type="string">high</encodingComplexity> 
<streamContext type="bag"> 
<presentationType type="string">audio-only</presentationType> 
<audioMode type="string">voice</audioMode> 
</streamContext> 
</stream> 


Music for Audio-Only Clips 


For audio-only music, choose a music codec that has a bit rate as close to the 
available bit rate without going over. For a 34 Kbps target speed, for example, a 
good choice is 32 Kbps Stereo Music High Response - RealAudio. This codec 

has a name of cook and a flavor of 21: 


<stream xsi:type="audioStream"> 
<pluginName type="string">rn-audiocodec-realaudio</pluginName> 
<codecName type="string">cook</codecName> 
<codecFlavor type="uint">21</codecFlavor> 
<encodingComplexity type="string">high</encodingComplexity> 
<streamContext type="bag"> 
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<presentationType type="string'">audio-only</presentationType> 
<audioMode type="string">music</audioMode> 
</streamContext> 
</stream> 


Voice Audio for Video Clips 


For audio with video, it’s generally advisable to allocate only 20 percent of a 
video’s bandwidth for audio. A good choice when streaming at 34 Kbps is 6.5 
Kbps voice. This codec has a name of sipr and a flavor of 0: 


<stream xsi:type="audioStream"> 
<pluginName type="string">rn-audiocodec-realaudio</pluginName> 
<codecName type="string">sipr</codecName> 
<codecFlavor type="uint">0</codecFlavor> 
<encodingComplexity type="string">high</encodingComplexity> 
<streamContext type="bag"> 
<presentationType type="string'">audio-video</presentationType> 
<audioMode type="string">voice</audioMode> 
</streamContext> 
</stream> 


Music Audio for Video Clips 


As with voice, a music codec for a video stream should consume only about 20 
percent of the total bit rate. A good choice is either 6 Kbps Music - RealAudio, 
or 8 Kbps Music - RealAudio if you want better sound quality. The following 
illustrates the 8 Kbps codec, which has a name of cook and a flavor of 0: 


<stream xsi:type="audioStream"> 
<pluginName type="string">rn-audiocodec-realaudio</pluginName> 
<codecName type="string">cook</codecName> 
<codecFlavor type="uint">0</codecFlavor> 
<encodingComplexity type="string">high</encodingComplexity> 
<streamContext type="bag"> 
<presentationType type="string">audio-video</presentationType> 
<audioMode type="string">music</audioMode> 
</streamContext> 
</stream> 
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The following table describes the properties that a video stream can contain. 


Each video stream section begins with a <stream xsi:type="videoStream"> tag 


and ends with a </stream> tag. 


Video Stream Properties 


Property Value Function 
codecName rv8|rv9|rv10 Defines the specific video codec 
type="string” used. The default is rv10 for 


RealVideo 10. See “RealVideo 
Codecs” on page 60 for more 
information. 


enableLossProtection 
type="bool” 


true|false 


Determines if error correction 
packets are added. The default is 
false. See “Loss Protection” on 
page 82. 


encodingComplexity 
type="string” 


low|medium|high 


Sets the encoding complexity, as 
described in “Encoding 
Complexity Modes” on page 79. 
The default is high. 


encodingType cbr| Sets constant bit rate encoding 

type="string” vbrBitrate| or a type of variable bit rate 
vbrQuality| encoding. The default is cbr. 
vbrUnconstrainedQuality| | Refer to “Stream Encoding 
vbrUnconstrainedBitrate Types” on page 342. 

maxFrameRate positive number from 0- Sets the maximum target frame 


type="double” 


60.000 


rate. The default is 30. See 
“Encoded Frame Rates” on page 
Se 


maxKeyFrameInterval 
type="double” 


positive number from 0 to 
60.000 


Sets the maximum number of 
seconds between video key 
frames. The default is 10. See 
“Maximum Time Between 
Keyframes” on page 80. 


maxStartupLatency 
type="double” 


number of seconds 
between 4.0 and 60.0 


Determines how long the clip 
buffers. The default is 4.0. See 
“Video Startup Latency” on 
page 80. 

(Table Page 1 of 2) 
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Video Stream Properties (continued) 


Property Value Function 
pluginName rn-videocodec-realvideo | Optionally defines the plug-in 
type="string” that encodes the stream. You use 


the same value for RealVideo 8, 
9, or 10. If omitted, 
RealProducer selects the plug-in 
based on the xsi:type value. 


quality positive integer from 1 to | Sets a quality target for VBR 
type="uint” 100 clips. A value of 100 represents 
the highest possible quality. For 
background, refer to “VBR 
Encoding Settings” on page 66. 
See also “Stream Encoding 
Types” on page 342. 

(Table Page 2 of 2) 


Stream Encoding Types 


The encodingType attribute for an audio or video stream uses one of the values 
described in the following table. The value you select determines whether 
RealProducer ignores or adheres to other audience settings. This attribute 
primarily affects video streams, but can be used with audio as well. If you do 
not define it for an audio stream, RealProducer uses vbrUnconstrainedQuality 
for the RealAudio lossless codec and cbr for all other audio codecs. 


Audio and Video Encoding Type Values 
encodingType Value Output 


cbr Constant bit rate stream based on the audience’s 
avgBitrate. The audience maxBitrate and the video 
stream quality values are ignored. Use this setting for all 
audio codecs other than the RealAudio lossless codec, 
which uses vbrUnconstrainedQuality. This is the only 
setting you can use for a video stream when packaging 
multiple streams into a single clip using SureStream 


technology. 


(Table Page 1 of 2) 
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Audio and Video Encoding Type Values (continued) 


encodingType Value 
vbrBitrate 


Output 


Variable bit rate stream based on the audience’s 
avgBitrate and maxBitrate settings. The video stream 
quality value is ignored. This is the standard setting for 
most variable bit rate clips. RealProducer may encode 
certain sections at speeds up to the maxBitrate setting, 
but attempts to encode an overall bit rate consistent with 
the avgBitrate value. The resulting average rate may be 
somewhat higher than the avgBitrate value, however. The 
vbrUnconstrainedBitrate encoding type generally encodes 
very close to the specified average bit rate, but has an 
unconstrained maximum bit rate. 


vbrQuality 


Variable bit rate stream based on the audience’s 
maxBitrate setting and the video stream’s quality setting. 
The audience’s avgBitrate setting is ignored. Use this 
value if you want to try to maintain the encoding quality 
at a certain level and it is not necessary to maintain a 
consistent, average bit rate. The quality level may be 
constrained by the maximum bit rate, however, 
particularly during fast-action scenes. 


vbrUnconstrainedQuality 


Variable bit rate stream based on the video stream’s 
quality setting. The audience’s avgBitrate and maxBitrate 
values are ignored. Use this value to maintain the 
encoding quality at a certain level and it is not necessary 
to maintain a consistent, average bit rate or adhere to a 
maximum bit rate. This is the only setting allowed for the 
RealAudio lossless codec. 


vbrUnconstrainedBitrate 


Variable bit rate stream based on the audience’s 
avgBitrate setting. The audience maxBitrate property and 
video stream quality setting are ignored. The resulting file 
may therefore have large bandwidth spikes, but the 
average bit rate will be close to the avgBitrate value. This 
is a better choice than vbrBitrate for creating a download 
clip at a specific file size. The final size will be the 
avgBitrate setting multiplied by the clip timeline. For 
example, a 60-second clip with an average bit rate of 450 
Kbps is approximately 27,000 Kbits, or 3.3 Megabytes. 
(Table Page 2 of 2) 
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encoding, see “Variable Bit Rate Video” on page 64. 
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Video Stream Bit Rate 


When you define a video stream, you do not set its bit rate directly. To 
determine the rate, take the audience’s avgBitrate value and subtract the rates 
for the selected audio stream. 


For a 256 Kbps audience, for example, the average bit rate may be 225 Kbps. If 
a 44 Kbps music audio codec is used for the sound track, the video’s visual 
track has an average bit rate of 181 Kbps (225 minus 44). If the video uses a 
voice sound track that consumes 32 Kbps, the visual track has an average bit 
rate of 193 Kbps (225 minus 32). 


For a variable bit rate clip, the same calculation using the audience’s 
maxBitrate value reveals the video’s maximum rate. If the maximum rate is 450 
Kbps, for instance, the video’s visual track can use a maximum bandwidth of 
406 Kbps (450 minus 44) when a music codec is used, or a maximum 
bandwidth of 418 Kbps (450 minus 32) if a voice codec is used. 


For More Information: The section “Audience Properties” on 
page 333 describes the audience values. For background on the 
division between the sound track and the visual track in a 
video clip, refer to “Soundtrack Bandwidth” on page 55. 


Video Stream Example 


The following example shows a video stream defined for a relatively low 
bandwidth, such as a dial-up modem. Because of the slow streaming speed, 
constant bit rate encoding is used with a maximum frame rate of 15 frames 
per second: 


<stream xsi:type="videoStream"> 
<codecName type="string">rv10</codecName> 
<enableLossProtection type="bool">false</enableLossProtection> 
<encodingComplexity type="string">high</encodingComplexity> 
<encodinglype type="string">cbr</encodingType> 
<maxFrameRate type="double">15.000000</maxFrameRate> 
<maxKeyFrameInterval type="double">10.000000</maxKeyFrameInterval> 
<maxStartupLatency type="double">4.000000</maxStartupLatency> 
<pluginName type="string">rn-videocodec-realvideo</pluginName> 
<quality type="uint">30</quality> 

</stream> 


APPENDIX 


SERVER FILE SYNTAX 


This appendix explains how to create and edit a server destination 
file, which records settings used to transmit a live stream to Helix 


Server for broadcast to RealPlayers. 


Note: If you are not familiar with XML syntax, refer to 
Appendix A for information about XML namespaces, tags, 
attributes, and values. 


Understanding Server Destination Files 


A server destination file specifies the IP address or DNS name of a Helix 
Server used to broadcast a live stream. For a multicast, the server destination 
file indicates the multicast address. The destination file also defines 
properties required by the server, such as error correction parameters and 
authentication passwords. These properties can vary by broadcast type. For 
example, error correction parameters are set in the server destination file for 
push broadcasts but not for pull broadcasts. 


After you create a server destination file, copy it to the servers directory under 
the main RealProducer installation directory. You then use the destination 
with the graphical application, as described in “Working with Server 
Templates” on page 207, or when running the command-line application, as 
explained in “Output and Destination Options” on page 261. Server 
destination files use the file extension .rpsd. 


For More Information: Before you create or modify a server 
destination file, be sure that you understand the broadcasting 
issues described in Chapter 10. 


Tip: RealProducer includes sample server destination files for 
all broadcast types in the samples/servers directory under the 
main RealProducer installation directory. You can use one of 


these files as the basis for creating your own server destination 
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A push server file can set up an account-based broadcast, a password-only 
broadcast, or a multicast. Following the XML declaration tag, you define all 
properties within a single list starting with a <destination> tag and ending with 
a </destination> tag. The pushServer value for the xsi:type property identifies 
the server destination as a push broadcast: 
<?xml version="1.0" encoding="UTF-8"?> 
<destination xsi:type="pushServer" xmlns="http://ns.real.com/tools/server.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/server.2.0 
http://ns.real.com/tools/server.2.0.xsd"> 

...all push server properties... 
</destination> 


The following sections in Chapter 11 provide background about how the 
broadcast properties function for the various types of push broadcasts: 


“Running an Account-Based Broadcast” on page 179 


“Setting Up a Password-Only Broadcast” on page 184 


“Multicasting a Live Stream” on page 189 


“Changing Advanced Push Broadcast Parameters” on page 194 


Push Server Properties 


The following table lists the possible push server properties. You define each 
property as a separate tag within the <destination> list. 


Push Server Properties 


Property Value Function 

address IP address or Provides the server’s IP address or 

type="string” DNS name DNS name. Ignored for multicasts. 

allowResends true|false Accepts the server’s packet resend 

type="bool” requests when set to the default value 
of true. This is ignored if transport is 
tcp or udp/multicast. 


(Table Page 1 of 4) 


Property 


authType 
type="string” 


APPENDIX D: Server File Syntax 


Push Server Properties (continued) 


Value 


account-based| 
single-password 


Function 


Sets the authentication type used. The 
default is account-based, which 
requires a user name and password. 
The single-password type requires 
only a valid password. Use single- 
password for password-only 
broadcasts and multicasts. 


enableTCPReconnect 
type="bool” 


true|false 


Re-establishes a dropped broadcast 
stream when set to the default value of 
true. Used only if transport is tcp. 


endPort 
type="uint” 


port number 


Defines the last port in the port range 
the server uses to receive broadcast 
data. The value can be 1 to 65535. The 
default is 30020. This property is 
ignored for account-based broadcasts. 


fecOffset seconds Offsets redundant packets by the 
type="uint” specified number of seconds if 
fecPercent is 100. The default is 0. 
fecPercent 0-50|100 Allocates a percentage of the stream 
type="uint” for error correction packets. The value 
can be any integer from 0-50 or 100. 
Values from 51 to 99 are assumed to 
be 100. The default is 0. 
listenAddress IP address Sets the IP address that RealProducer 
type="string” uses to listen for packet resend 
requests. This property is ignored for 
multicasts. 
metadataResendInterval | seconds Defines the number of seconds 


type="uint” 


between metadata resends when 
transport is udp. Ignored if transport 
is tcp. The default is 30. 


multicastAddress 
type="string” 


multicast IP 
address 


Indicates the multicast address to use. 
Ignored if transport is not 
udp/multicast. 


multicastTTL 
type="uint” 


router hops 


Sets the number of router hops 
allowed for a multicast. Valid values 
are 1 to 255. The default is 16. Ignored 
for other types of broadcasts. 

(Table Page 2 of 4) 
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Push Server Properties (continued) 


Property Value Function 

name name Names the server destination for use 

type="string” by the graphical application. Used 
only in a job file. With a server 
destination file, the file name is used 
as the destination name. 

password string Validates the server connection. For 

type="string” account-based broadcasts, the server’s 
authentication database defines the 
password. For password-only 
broadcasts or multicasts, the receiver 
definition sets the password. 

path path name Defines an optional, virtual path used 


type="string” 


for server features such as archiving or 
splitting. Include a trailing forward 
slash, as in news/. The value appears 
in the URL ahead of the stream name, 
as in news/live.rm. 


pluginName 
type="string” 


rm-server-rbs 


Identifies the plug-in that handles the 
stream connection. 


port 
type="uint” 


port number 


For an account-based broadcast, this 
defines the HTTP port on the server, 
which is typically 80. For a password- 
only broadcast or multicast, this 
defines the first port in the port range 
the server uses to receive broadcast 
data. The value can be 1 to 65535. The 
default is 30001. 


savePassword 
type="bool” 


true|false 


Saves the password as plain text in the 
server destination file when set to 
true. The password is used only with 
the graphical application. With the 
command-line application, you must 
enter the password on the command 
line. The default is false. 


statisticsUpdateInterval 
type="uint” 


1 to 604800 


Sets the number of seconds between 
statistics updates from the server in 
account-based broadcasts only. The 
default is 10. 

(Table Page 3 of 4) 
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Push Server Properties (continued) 


Property Value Function 

streamname stream name Defines the stream name used in the 

type="string” broadcast URL. This should use the 
appropriate extension, as in live.rm or 
live.rmvb. 

TCPReconnectInterval 1 to 3600 Indicates the number of seconds to 

type="uint” wait before attempting to re-establish 


an account-based broadcast or a 
password-only broadcast that uses 
TCP transport. The default is 10. 


transport udp/unicast| Defines the broadcast transport and 
type="string” udp/multicast| mode. The default is udp/unicast. For 
tcp password-only broadcasts and 


multicasts, this value must match the 
setting on the receiver. 


username name Validates the broadcast. The server 
type="string” defines the user name and password 
in its authentication database. Used 
only with account-based broadcasts. 
(Table Page 4 of 4) 


Push Server Examples 


The following sections provide examples of the three standard types of push 
broadcasting: account-based, password-only, and multicast. 


Account-Based Example 


The following example defines an account-based broadcast. The authType 
property sets the broadcast type. The username and password properties supply 
log-in credentials for the Helix Server authentication database. 


<?xml version="1.0" encoding="UTF-8"?> 
<destination xsi:type="pushServer" xmlns="http://ns.real.com/tools/server.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/server.2.0 
http://ns.real.com/tools/server.2.0.xsd"> 
<pluginName type="string">rn-server-rbs</pluginName> 
<authType type="string">account-based</authType> 
<address type="string">helixserver.example.com</address> 
<port type="uint">80</port> 
<endPort type="uint">0</endPort> 
<username type="string">realmedia-encoder</username> 
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<password type="string">453ERP098zu</password> 

<savePassword type="bool">true</savePassword> 

<transport type="string">udp/unicast</transport> 

<listenAddress type="string">172.23.104.188</listenAddress> 

<fecPercent type="uint">20</fecPercent> 

<fecOffset type="uint">10</fecOffset> 

<metadataResendInterval type="uint">30</metadataResendInterval> 

<allowResends type="bool">true</allowResends> 

<statisticsUpdateInterval type="uint">2</statisticsUpdateInterval> 
</destination> 


Password-Only Example 


The following example defines a password-only broadcast, as shown in the 
authType property value. There is no user name, and the log-in password is 
defined in the Helix Server receiver configuration. The metadataResendInterval 
property defines how long it may take Helix Server to re-establish a dropped 
broadcast stream. 


<?xml version="1.0" encoding="UTF-8"?> 
<destination xsi:type="pushServer" xmlns="http://ns.real.com/tools/server.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/server.2.0 
http://ns.real.com/tools/server.2.0.xsd"> 

<pluginName type="string">rn-server-rbs</pluginName> 

<authType type="string">single-password</authType> 

<address type="string">helixserver.example.com</address> 

<port type="uint">30001</port> 

<endPort type="uint">30020</endPort> 

<savePassword type="bool">true</savePassword> 

<password type="string">546zRGW23</password> 

<transport type="string">udp/unicast</transport> 

<listenAddress type="string">172.23.104.188</listenAddress> 

<fecPercent type="uint">20</fecPercent> 

<fecOffset type="uint">10</fecOffset> 

<metadataResendInterval type="uint">30</metadataResendInterval> 

<allowResends type="bool">true</allowResends> 

<enableTCPReconnect type="bool">true</enableTCPReconnect> 

<TCPReconnectInterval type="uint">10</TCPReconnectInterval> 

<statisticsUpdateInterval type="uint">2</statisticsUpdateInterval> 
</destination> 
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Multicast Example 


The next example illustrates a server destination file for a multicast. The 
authType property is set to single-password because the password defined in the 
Helix Server receiver configurations is required. The transport property creates 
the multicast through its udp/multicast value. The multicastAddress property 
defines the multicast address monitored by all Helix Server receivers. 


<?xml version="1.0" encoding="UTF-8"?> 
<destination xsi:type="pushServer" xmlns="http://ns.real.com/tools/server.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/server.2.0 
http://ns.real.com/tools/server.2.0.xsd"> 

<pluginName type="string">rn-server-rbs</pluginName> 

<authType type="string">single-password</authType> 

<port type="uint">30001</port> 

<endPort type="uint">30020</endPort> 

<savePassword type="bool">true</savePassword> 

<password type="string">3542zdf22</password> 

<transport type="string">udp/multicast</transport> 

<multicastAddress type="string">225.229.1.1</multicastAddress> 

<multicastTTL type="uint">16</multicastTTL> 

<fecPercent type="uint">20</fecPercent> 

<fecOffset type="uint">10</fecOffset> 

<metadataResendInterval type="uint">30</metadataResendInterval> 

<statisticsUpdateInterval type="uint">2</statisticsUpdateInterval> 
</destination> 


Legacy Push Server Syntax 


A legacy push server file sets up a broadcast stream between RealProducer and 
RealSystem Server version G2, 7, or 8. Following the XML declaration tag, you 
define all properties within a single list starting with a <destination> tag and 
ending with a </destination> tag. The g2PushServer value for the xsi:type 
property identifies this server definition as a legacy push broadcast: 
<?xml version="1.0" encoding="UTF-8"?> 
<destination xsi:type="g2PushServer" 
xmlns="http://ns.real.com/tools/server.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/server.2.0 
http://ns.real.com/tools/server.2.0.xsd"> 

...all legacy push server properties... 
</destination> 
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For More Information: Refer to “Setting up a Legacy Broadcast” 


on page 199 for background information about how the legacy 


server properties function. 


Legacy Server Properties 


The following table lists the possible legacy push properties. You define each 


property as a separate tag within the <destination> list. 


Legacy Push Server Properties 


Property Value Function 

address IP address or Provides the server’s IP address or DNS name. 

type="string” DNS name 

name name Names the server destination for use by the 

type="string” graphical application. Used only in a job file. 
With a server destination file, the file name is 
used as the destination name. 

password string Validates the broadcast. The server defines the 

type="string” user name and password in its authentication 
database. 

path path name Sets an optional, virtual path used for server 

type="string” features such as archiving or splitting. Include a 
trailing forward slash, as in news/. The value 
appears in the URL ahead of the stream name, 
as in news/live.rm. 

pluginName rm-server-g2 Identifies the plug-in that handles the stream 

type="string” connection. 

port port number Defines the server port where the stream is 

type="uint” sent. The default is 4040. 

savePassword true|false Saves the password as plain text in the server 

type="bool” destination file when set to true. The default is 
false. 

streamname stream name Defines the stream name used in the broadcast 

type="string” URL. This should use the appropriate 
extension, as in live.rm. 

transport udp/unicast|tcp | Defines the broadcast transport and mode. The 

type="string” default is udp/unicast. 

username name Validates the broadcast. The server defines the 

type="string” user name and password in its authentication 


database. 
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Legacy Server Example 


The following example defines a legacy push broadcast. The username and 
password properties supply log-in credentials for the RealSystem server 
authentication database. This broadcast uses the preferred udp/unicast 
transport. 


<?xml version="1.0" encoding="UTF-8"?> 
<destination xsi:type="g2PushServer" xmlns="http://ns.real.com/tools/server.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/server.2.0 
http://ns.real.com/tools/server.2.0.xsd"> 
<pluginName type="string">rn-server-g2</pluginName> 
<address type="string">realserver.example.com</address> 
<port type="uint">4040</port> 
<username type="string">realmedia-encoder</username> 
<savePassword type="bool">true</savePassword> 
<password type="string">456TWYzq</password> 
<transport type="string">udp/unicast</transport> 
</destination> 


Pull Server Syntax 


A pull server file defines a broadcast in which Helix Server requests the 
broadcast stream from RealProducer. Following the XML declaration tag, you 
define all properties within a single list starting with the <destination> tag and 
ending with the </destination> tag. The pullServer value for the xsi:type 
property identifies this server definition as a pull broadcast: 
<?xml version="1.0" encoding="UTF-8"?> 
<destination xsi:type="pullServer" 
xmlns="http://ns.real.com/tools/server.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/server.2.0 
http://ns.real.com/tools/server.2.0.xsd"> 

...all pull server properties... 
</destination> 


For More Information: Refer to “Running a Pull Broadcast” on 
page 202 for background information about pull broadcast 
properties. 
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Pull Server Properties 


The following table lists the possible pull broadcast properties. You define 


each property as a separate tag within the <destination> list. 


Pull Server Properties 


Property Value Function 

listenAddress IP address Defines the IP address that RealProducer uses to 

type="string” listen for pull requests. Do not use a DNS name. 
A value of 0 indicates the default address on the 
RealProducer computer’s network interface card. 

listenPort port number Sets the port that RealProducer monitors for pull 

type="uint” requests. The value can be 1 to 65535. The default 
is 3031. You can use the same port for multiple 
broadcasts running on the same machine. 

name name Names the server destination for use by the 

type="string” graphical application. Used only in a job file. 
With a server destination file, the file name is 
used as the destination name. 

password string Validates the broadcast. The serve password in the 

type="string” receiver configuration must match this value. 

path path name Sets an optional, virtual path used for server 

type="string” features such as archiving or splitting. Include a 
trailing forward slash, as in news/. The value 
appears in the URL ahead of the stream name, as 
in news/live.rm. 

pluginName m-server-rbs_ | Identifies the plug-in that handles the stream 

type="string” connection. 

savePassword true|false Saves the password as plain text in the server 

type="bool” destination file when set to true. The default is 
false. 

serverlimeout |0 to 86400 Sets the number of seconds that RealProducer 


type="uint” waits before stopping the broadcast packets after 
it receives no more “keep alive” messages from the 
server. The default is 30. 

streamname stream name Defines the stream name used in the broadcast 

type="string” URL. This should use the appropriate extension, 


as in live.rm or live.rmvb. 
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Pull Server Example 


The following example defines a pull broadcast. RealProducer listens on the IP 
address and port defined by listenAddress and listenPort, respectively, for 
broadcast requests by Helix Server. The password property verifies access to the 
stream. In a pull broadcast, the initiating receiver specifies many of the 
broadcast parameters, such as whether forward error correction is used. 


<?xml version="1.0" encoding="UTF-8"?> 
<destination xsi:type="pullServer" xmlns="http://ns.real.com/tools/server.2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://ns.real.com/tools/server.2.0 
http://ns.real.com/tools/server.2.0.xsd"> 
<pluginName type="string">rn-server-rbs</pluginName> 
<listenAddress type="string">172.23.104.188</listenAddress> 
<listenPort type="uint">3031</listenPort> 
<savePassword type="bool">true</savePassword> 
<password type="string">WEP0342zqd</password> 
<serverlimeout type="uint">30</serverlimeout> 
</destination> 
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APPENDIX 


E 


PREFERENCE FILE SYNTAX 


This appendix describes the properties of the RealProducer 
preferences file, which affect the operation of both the graphical 
application and the command-line application. You can edit this file 


manually if you need to change the preferences settings. 


Note: If you are not familiar with XML syntax, refer to 
Appendix A for information about XML namespaces, tags, 


attributes, and values. 


Editing RealProducer Preferences 


RealProducer records application preferences in the file producer.pref, located 
in the main installation directory. This XML-formatted text file specifies 
values such as the path to audience and server files. It also sets the location of 
the temporary directory used when encoding clips. You can change most 
preference properties using the graphical application, as described in 
“Adjusting RealProducer Preferences” on page 149. If you are using the 
command-line application, edit the preferences using any text or XML editor. 


Note: This appendix does not describe how to change the 
applicationState properties, which record the graphical 
application’s display state. Under normal circumstances, you 
should not need to edit these properties. 
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File Path Preferences 


The <paths/> tag contains three properties that set the paths to files used by 
RealProducer. 


Path Preferences 
Property Value Function 


audiences | path Provides the full path to the directory that stores 
audience files, which are described in Appendix C. 
Relative paths are not allowed. The default is the 
audiences directory under the main installation 
directory. 


servers path Specifies the full path to the directory that stores 
server files, which are described in Appendix D. 
Relative paths are not allowed. The default is the 
servers directory under the main installation 
directory. 


tempDir path|%TEMP%| | Indicates the directory used to store temporary files 
%OUTPUTDIR% | during encoding. See “Temporary Directory” on page 
358. 


Temporary Directory 


For tempDir, you can enter the full path name of the directory to use as the 
temporary directory. Or, you can use one of the following variables: 


+ If you use %TEMP% as the value, RealProducer uses the same directory 
specified by the Windows TEMP or Linux TEMPDIR variable. If the Linux 
TEMPDIR variable is not set, RealProducer uses the /tmp directory. 


+ Use a value of %OUTPUTDIR% to set the temporary directory for each job to 
the same directory used to store the job’s output clip. 


Tip: RealProducer operates faster if the temporary directory 
resides on the local RealProducer machine, rather than a 
network drive. 


Note: After you restart the RealProducer graphical application, 
the graphical preferences dialog lists the full path to the 
directory specified by the %TEMP% or %OUTPUTDIR% variable. 
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File Path Example 


The following example illustrates the <paths/> tag: 


<paths audiences="C:\Program Files \Real\RealProducer Plus 10\audiences\" 
servers="C:\Program Files\Real\RealProducer Plus 10\servers\" 
tempDir="%TEMP%"/> 


Log File Preferences 


The <fileLogging/> tag uses the properties described in the following table to 
set the RealProducer logging preferences. 


Log File Preferences 


Property Value Function 


category error|warning| | Sets the logging category. Choose any 
info|diagnostic | combination of categories, separating them 
with commas. For more information on 
categories, refer to “Logging Category (-lc)” 
on page 274. 


disable true|false Turns off logging when set to true. The 
default is false. 


enableRolling true|false Enables the creation of multiple log files 
(log rolling) when set to true. The default is 
false. 


filename file name Sets the log file name. You can use a full 
path or a path relative to the installation 
directory. 


filterFunctionalArea | true|false Filters the log according to functional area 
when set to true. The default is false, which 
captures all logging areas. 


format detailed|short | Determines the log format. You can choose 
short to log only the job name and message. 
The default detailed format logs more 

information, such as the message category, 
functional area, time, and message number. 


formatSeparator character Defines the character used to separate 
entries on a line within the log. The default 
is \t for a tab. 


(Table Page 1 of 2) 
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Property 


functionalArea 


Log File Preferences (continued) 


Value 


all|list 


Function 


Defines which functional areas are logged. 
The default value all logs all areas. 
Otherwise, enter a comma-separated list of 
specific areas. 


previousFilename 


file name 


Indicates the file name of the last log 
created if log rolling is used. The file 
extension includes a numeric designation 
to indicate the order of the logs. For 
example, for a log named producer.log, the 
first rolled file is named producer.log1, the 
second is producer.log2, and so on. 


rollTimeIntervalType 


hourly|daily| 
weekly|monthly 


Determines how frequently the log file is 
rolled if time-based rolling is turned on. 
The default is monthly. 


rollType 


size|time 


Determines if log files are rolled according 
to size or preset time if log rolling is 
enabled. The default is time. 


sizeRollSize 


Log File Example 


1-99999 


Sets the size of the log file in Megabytes 
when log files are rolled according to size. 
Use any integer up to 99999. 

(Table Page 2 of 2) 


The following example illustrates the <fileLogging/> tag: 


<fileLogging format="detailed" 
formatSeparator="\t" 


disable="false" 


filename="producer.log" 
previousFilename="C:\Program Files\Real\RealProducer Plus 10\producer.log" 
enableRolling="false" 


rollType="time" 
sizeRollSize="5" 


rollTimeIntervalType="monthly" 
filterFunctionalArea="false" 
functionalArea="all" 
category="error,warning,informational"/> 


APPENDIX E: Preference File Syntax 


Log Viewing Properties 


The log viewer is available through the graphical application, as described in 
“Viewing Log Messages” on page 147. The <screenLogging/> tag uses the 
properties described in the following table to set the log viewer preferences. 


Log Viewing Preferences 


Property Value Function 


disable true|false Turns off log viewing when set to true. The 
default is false. 


filterFunctionalArea | true|false Filters log viewing according to functional 
area when set to true. The default is false, 
which displays all logging areas. 


functionalArea all|list Defines which functional areas are 
displayed. The default value all displays all 
areas. You can also create a comma- 
separated list of specific areas. 


category error|warning| | Sets the logging category. Choose any 
info|diagnostic | combination of categories, separating them 
with commas. For more information on 
categories, refer to “Logging Category (-lc)” 
on page 274. 


Log File Example 


The following example illustrates the <screenLogging/> tag: 


<screenLogging disable="false" 
filterFunctionalArea="false" 
functionalArea="all" 
category="error,warning, info" /> 
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GLOSSARY 


artifact 
A visual imperfection in an encoded video clip. Too many artifacts can 


make the video look blocky. 


bandwidth 
The upper limit on the amount of data, typically expressed as Kilobits per 


second (Kbps), that can pass through a network connection. 

binary tag 
An XML tag that comprises opening and closing tags, such as <List> and 
</List>. 

bit 
The smallest unit of measure of data in a computer. A bit has a binary 
value, either 0 or 1. 

bit rate 
A measure of bandwidth, expressed as the number of bits transmitted per 
second. A 28.8 Kbps modem, for example, can transmit or receive around 
29,000 bits per second. 


broadcast 
To deliver a presentation, whether live or prerecorded, in which all viewers 
join the presentation in progress. Contrast to on-demand. 

buffering 
The receiving and storing of data before it is played back. A clip’s initial 
buffering is called preroll. After this preroll, excessive buffering may stall 
the presentation. 


byte 


A common measurement of data. One byte consists of 8 bits. 
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cable modems 
Devices that allow rapid transmission and reception of data over 


television cable. They are digital devices, unlike dial-up modems, which 
transmit analog data. 

CBR 
Constant Bit Rate. A type of RealVideo encoding in which all parts of the 
video play back at the same bit rate. Contrast to VBR. 

client 
A software application that receives data from a server. A Web browser is a 
client of a Web server. RealPlayer is a client of Helix Server. 

clip 
A media file within a presentation. Clips typically have an internal 
timeline, as with RealAudio and RealVideo. 

codec 
Coder/decoder. Codecs convert data between uncompressed and 
compressed formats, reducing the bandwidth a clip consumes. 


download 
To send a file over a network with a nonstreaming protocol such as HTTP. 


Contrast to stream. 

DSL 
Digital Subscriber Line. A technology for transmitting digital data over a 
regular telephone line much faster than through dial-up modems. 

duress stream 
A low-bandwidth SureStream audio or video stream that Helix Server uses 
if a connection’s available bandwidth drops greatly. 


encoding 
Converting a file into a compressed, streaming format. For example, you 


can encode WAV files as RealAudio clips. 


fps 
Frames Per Second. The number of video frames that displays each second 
in a streaming video clip. 

frequency response 
A measure of audio clip quality. The higher a clip’s frequency response, 
the more frequencies it can faithfully reproduce. 


Glossary 


Helix Server 
RealNetworks server software used to stream multimedia presentations to 


RealPlayer 10. 


Helix Server administrator 
The person in charge of setting up and running Helix Server. 


HTTP 
Hypertext Transport Protocol. The protocol used by Web servers to 


communicate with Web browsers. In contrast, Helix Server streams clips 
to RealPlayer with RTSP. 


ISDN 
Integrated Services Digital Network. Technology that makes digital data 


connections at 64 or 112 Kbps possible over telephone lines. 

ISP 
Internet Service Provider. A company that provides access to the Internet. 
Many ISPs have Helix Server available to stream media clips. 


kilobit (Kb) 
A common unit of data measurement equal to 1024 bits. A kilobit is 
usually referred to in the context of bit rate per unit of time, such as 
Kilobits per second (Kbps). 

kilobyte (KB) 
A common unit of data measurement equal to 1024 bytes or 8 Kilobits. 


LAN 
Local Area Network. A computer network confined to a local area, such as 


a single building. LANs vary in speed, with bandwidth shared among all 
networked devices. 

lossy 
A compression scheme that lowers clip size by discarding nonessential 
data from the source file. Both RealAudio and RealVideo are lossy. 


metafile 
Another name for a Ram file. 


mouseover 
The action of moving a computer screen pointer over an interactive area. 


An animated button may change appearance on a mouseover, for example. 
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namespace 
An XML declaration that identifies the features used in a SMIL 
presentation. For SMIL 2.0 and higher, the <smil> tag must declare a 


namespace. 


on-demand 
A type of streaming in which a clip plays from start to finish when a user 


clicks a link. Most clips are streamed this way. Contrast to broadcast. 


PNA 
A proprietary protocol Helix Server uses for backward compatibility with 
RealPlayer 3 through 5. URLs using PNA start with pnm://. 


port 
A connection to a server, designated by a number such as 8080. Helix 


Server uses different ports for the RTSP, HTTP, and PNA protocols. 


preroll 
Buffering that occurs just before a clip plays back. Preroll should be no 
more than 15 seconds. 

presentation 
A group of clips coordinated through SMIL and streamed from Helix 
Server to RealPlayer 10. 


Ram file 
A text file that uses the file extension .ram or .rpm. It launches RealPlayer 


and gives it the URL to a streaming clip or presentation. 


RDT 
RealNetworks Data Transport. The proprietary data package Helix Server 


uses (along with RTSP) when communicating with RealPlayer. Contrast 
to RTP. 


RealAudio 
A clip type for streaming audio over a network. RealAudio clips use the .rm 
extension. 

RealPlayer 10 
The successor to RealOne Player, RealPlayer 10 combines streaming and 
digital download technologies. 


Glossary 


RealPix 
A clip type (file extension .rp) for streaming still images over a network. 


RealPix uses a markup language for creating special effects such as fades 
and zooms. 

RealPlayer G2 
The RealNetworks client software that introduced plug-ins and the ability 
to update itself. It, along with the later RealPlayer 7 and RealPlayer 8, 
supports the SMIL 1.0 standard. 

RealProducer 
The primary RealNetworks tool for encoding RealAudio and RealVideo 
clips. 

RealText 
A clip type (file extension .rt) for streaming text over a network. It uses a 
markup language for formatting text. 

real-time 
Delivered as it occurs. For example, a live event is streamed across a 
network in a real-time broadcast. 

RealVideo 
A clip type for streaming video over a network. RealVideo clips use the 
extension .rm. 

rebuffering 
An undesirable state in which RealPlayer must pause a presentation to 
wait for streaming data to arrive. Rebuffering can result from network 
conditions, or a poorly produced presentation. 

RTP 
Real-Time Transport Protocol. The open, standards-based data package 
Helix Server uses (along with RTSP) to communicate with RTP-based 
clients. Contrast to RDT. 

RTSP 
Real-Time Streaming Protocol. An open, standards-based control protocol 
that Helix Server uses to stream clips to RealPlayer or any RTP-based 
client. Contrast to HTTP. 


server 
1. A software application, such as a Web server or Helix Server, that sends 


requested data over a network. 


2. A computer that runs server software. 
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SMIL 
Synchronized Multimedia Integration Language. A markup language for 


specifying how and when each clip plays within a presentation. SMIL files 
use the extension .smil. 

stream 
1. To send a media clip over a network so that it begins playing back as 
quickly as possible. 
2. A flow of a single type of data, measured in Kilobits per second (Kbps). 
A RealVideo clip’s soundtrack is one stream, for example. 

SureStream 
A RealNetworks technology that enables a RealAudio or RealVideo clip to 
stream at multiple bit rates. 


U unary tag 
An XML tag that includes a closing slash, as in <ref/>. 


URL 
Uniform Resource Locator. A location description that enables a Web 
browser or RealPlayer to receive a clip stored on a Web server or Helix 


Server. 


VV VBR 
Variable Bit Rate. A type of RealVideo encoding that enables RealPlayer to 


play different parts of the video at different bit rates, even though the 
video is streamed at a constant rate. Contrast to CBR. 


X XML 


Extensible Markup Language. The parent language for SMIL. XML allows 
one to develop flexible, standardized languages for any purpose. 
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A __account-based broadcast 
advanced settings, 194 
advantages of, 179 
archiving, 181 
broadcast steps, 180 
command-line option, 262 
overview, 179 
redundant encoders, 181 
server 

authentication, 181 
destination syntax, 346 
destinations, 182 
ports used, 181 
preparation, 180 
starting and stopping, 184 
statistics, 181 
statistics update interval, 195 
stream name, 182 
URLs, 209 
archiving broadcasts, 173 
audience file 
audience section, 333 
audio stream 
contexts 
defining, 336 
examples, 339 
less than four, 338 
properties, 335 
compared to job file, 332 
overview, 331 
properties 
audioMode, 337 
avgBitrate, 333 
codecFlavor, 336 
codecName 
for audio, 336 
for video, 341 


enableLossProtection, 341 
encodingComplexity 

for audio, 336 

for video, 341 
encodingType 

for audio, 336 

for video, 341 
maxBitrate, 334 
maxFrameRate, 341 
maxKeyFramelInterval, 341 
maxStartupLatency, 341 
name, 334 
presentationType, 337 
quality, 342 
streamContext, 336 


streams section, 334 
template location, 151 
video stream 


bit rate, 344 

example, 344 

properties, 341 

stream encoding types 
cbr, 342 
overview, 342 
vbrBitrate, 343 
vbrQuality, 343 
vbrUnconstrainedBitrate, 343 
vbrUnconstrainedQuality, 343 


audiences 
audio codec selection, 103 
categories 


discrete multichannel audio, 133 
high-bandwidth streaming, 113 
lossless audio, 138 
low-bandwidth streaming, 106 
mobile devices, 117 
quality-based downloads, 125 
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stereo surround audio, 129 

variable bit rate downloads, 120 
CBR or VBR selection, 156 
changing audio codecs, 158 
choosing between, 105 
constant vs. variable rates, 18 
default settings, 99 
editing 

for active job, 154 

for all jobs, 154 
in graphical application, 98 


job file references, 326 


on command line, 269 
overview, 18, 103 
statistics, 144 

template name, 156 

video codec selection, 104 
video settings, 157 


audio 
audience file stream properties, 335 


cables, 49 
DC offset, 50 
delay compensation prefilter, 317 
digitizing, 50 
disabling 
in job file, 325 
on capture, 271 
discrete multichannel audio, 43 
dynamics compression, 51 
editing programs, 16 
equipment quality, 48 
frequency equalization, 51 
gain 
compression, 49 
in graphical application, 143 
in job file, 316 
on command line, 258 
input formats, 25 
input levels, 49 
live capture, 88 
lossless, 45 
monitoring levels, 142 
normalization, 50 
optimizing, 50 
recording tips, 48 
resampling quality 


in graphical application, 96 

in job file, 325 

on command line, 272 
resampling while broadcasting, 177 
sampling width, 49 
signal-to-noise ratio, 49 
source media, 48 
stereo surround, 41 


see also RealAudio 
audio delay compensation filter, 317 
audio gain filter 


in graphical application, 143 
in job file, 316 
on command line, 258 


audio mode 


in graphical application, 96 
in job file, 325 
on command line, 271 


bandwidth 
clip characteristics 


RealAudio, 34 
RealVideo, 55 
negotiation, 61 


SureStream clips, 61 
bandwidth targets, 157 
batch encoding 


in graphical application, 86 


on command line, 252 
Betacam video, 69 
black-level correction 


in graphical application, 95 
in job file, 314 


on command line, 259 
overview, 78 

broadcasting 
advanced push options, 194 
archiving the broadcast stream 


on RealProducer, 173 
on the server, 173 


audio resampling, 177 
audio volumes, 49 


broadcast quality, 168 


encoder redundancy, 172 
encoding complexity reduction, 176 


forward error correction, 196 
frame rate reduction, 176 
load management, 174 

load testing, 175 

metadata resend interval, 195 
multiple destinations, 169 


network address translation issues, 195 


packet resends, 195 

reconnection attempts, 194 
redundant stream protection, 197 
resend listen address, 195 

server destination templates, 207 
simulated live broadcasts, 169 
SMIL files, 167 


splitting streams among servers, 170 


TCP transport, 167 

trial run, 168 

UDP transport, 166 

URLs, 209 

video display latency, 167 

video features to avoid, 177 
virtual paths, 174 

see also account-based broadcast 
see also legacy broadcast 

see also multicasting 

see also password-only broadcast 
see also pull broadcast 


cable shielding, 49 
camel case, 286 
clip information 
editing with RealMedia Editor, 216 
in graphical application, 92 
in job file, 295 
on command line, 256 
overriding in events file, 228 
RealPlayer display of, 93 
codecs 
see RealAudio 
see RealVideo 
command-line application 
batch encoding, 252 
clip information options, 256 
encoding options, 269 
filter options, 258 


Index 


help options, 276 
input options, 252 
job file 


advantages of using, 241 
options, 249 


logging options, 274 
options 


-a author, 257 

-ac audio capture device ID, 253 

-ad audience definitions or files, 269 

-ag audio gain filter, 258 

-am audio mode, 271 

-ap audio capture device port, 253 

-arq audio resampling quality, 272 

-bl black-level filter, 259 

-C copyright, 257 

-cj create job file, 249 

-cm capture mono audio, 254 

-crrcrop video, 260 

-cs capture frame size, 256 

-d capture duration, 256 

-da disable audio, 271 

-daw disable audio watchdogs, 259 

-de description, 257 

-di inverse-telecine and de-interlace fil- 
ters, 259 

-dlf disable logging to file, 275 

-dls disable logging to screen, 275 

-drs destination file roll size, 262 

-drt destination file roll time, 262 

-dt disable two-pass encoding, 270 

-duc disable codec update, 251 

-dv disable video, 272 

-eco encoding complexity, 274 

-h display help, 276 

-i input file or directory, 252 

-j job file name, 249 

-k keywords, 257 

-lc logging category, 274 

-m display detailed help, 276 

-nf video noise filter, 261 

-0 output file or directory, 261 

-pa print audiences, 277 

-pd print device information, 276 

-pid process ID file, 276 

-ps print servers, 277 
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-q quiet mode, 275 playback requirements, 45 

-r content rating, 258 sound system requirements, 44 
-rq video resize quality, 273 supported number of channels, 44 
-1s resize video, 273 documentation library, 4 

-sd server template or file, 267 duration element syntax, 288 


-sg legacy push server, 266 
-si pull server destination, 265 
-sp push server destination, 262 E 
-t title, 257 
-V print version, 277 
-vc video capture device ID, 254 
-vco video codec override, 273 
-vf video format, 255 
-vm video mode, 272 
-vp video device port, 255 
output and destination options, 261 
overview, 241 
process IDs, 243 
return value, 245 
signal trapping, 243 
stopping, 243 
syntax, 242 


dynamics compression, 51 


encoding complexity 
automatic reduction in broadcasts, 176 
in audience file, 336, 341 
overriding on command line, 274 
overview, 79 

error correction, 82 

events file 
creating, 226 
extended clip information, 229 
extracting events information, 239 
merging through RealMedia Editor, 217 
merging with clip, 238 
overview, 225 
title, author, and copyright, 228 


temporary directory, 242 URLs, 226 
usage examples, 277 
F file rolling 
D de-interlace filter, 77 in job file, 322 


in graphical application, 95 oneominand Ine 202 


in job file, 312 film-to-video transfer, 76 
on command line, 259 forward error correction, 196 
overview, 77 frame rates 
destinations RealVideo, 57 
compared to outputs, 19 video capture, 70 
in graphical application, 87 
in job file, 319 H hardware requirements 
multiple servers, 169 Linux, 28 
on command line, 261 Windows, 27 
overview, 19 Helix Server, 23 
digital rights management, 21 administration guide, 4 
digital video formats, 69 Helix Server Administration Guide, 4 
DirectX requirements, 25 HTML pages 
discrete multichannel audio opening automatically, 226 
audiences, 133 opening on mouse click, 231 
description, 44 
encoding with stereo codecs, 45 I image maps 
file formats available, 44 alternate text, 237 
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creating, 231 audiences 
duration, 232 combining multiple audiences, 327 
extracting map information, 239 importing from audience file, 330 
hot spots references, 326 
circular, 234 section for defining, 329 
cropping, 236 tips for defining, 329 
image map programs, 236 audio 
overlapping, 236 device ID and port, 304 
polygonal, 235 disabling, 325 
rectangular, 233 filters 
tips, 236 delay compensation, 317 
merging through RealMedia Editor, 217 gain, 316 
merging with clip, 238 overview, 307 
player actions, 237 clip information, 295 
URLs, 233 command line use, 249 
inputs creating 
audio formats accepted, 25 in graphical application, 83 
color formats, 26 manually, 292 
file default settings, 85 
in graphical application, 87 destinations, 320 
in job file, 301 file, 320 
on command line, 252 server, 323 
live capture example, 295 
audio on command line, 253 exclusive features, 291 
in graphical application, 88 features not in RealProducer Basic, 293 
in job file, 303 file and path conventions, 302 
video on command line, 254 file rolling, 322 
overview, 15 input tag, 300 
video formats accepted, 25 inputs, 299 
installation capture, 303 
Linux, 28 examples, 305 
Windows, 27 file, 301 
interlaced video, 77 multiple, 299 


single, 299 

job manager, 86 

job section, 294 

media profile, 324 
audience references, 326 


Introduction to Streaming Media, 4 
inverse-telecine filter, 76 
in grapical application, 95 
in job file, 312 
on command line, 259 


: example, 327 
overview, 76 ore a fe - 
application 
IP address discovery, 266 OPENING Ih Braplica apPicatlon, 
outputs 


file name conventions, 321 


Javascript, 23 output section, 319 


job file see also job file destinations 
archive files, 321 overview, 291 
audience definitions, 332 parallel inputs 
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defining, 299 resizing 

example, 306 quality, 326 
properties width and height, 310 

audienceRefs, 325 resizing methods, 309 

audioCaptureMono, 303 job manager, 86 

audioDeviceID, 303 jobs 

audioDevicePort, 303 encoding, 141 

audioMode, 325 input for, 87 

audioResamplingQuality, 325 manager, 86 

destinationRollSize, 320 opening, 84 

destinationRollTime, 320 overview, 17 

disableAudio, 301, 325 

disableLoadManagement, 294 L legacy broadcast 


disableVideo, 325 
duration, 303 
enableTwoPass, 294 
filename, 301, 321 
name, 321 
for captures, 303 
for clip information, 296 
for inputs, 301 


archiving on server, 199 
command-line option, 266 
overview, 199 
server 
destination, 200 
destination syntax, 351 
port, 199 
: preparation, 199 
outputHeight, 325 : ‘ 

: starting and stopping, 201 
outputWidth, 326 <predinnarnié: 200 
resizeQuality, 326 URLs. 209 , 
value, 296 ; 
videoDeviceID, 304 
videoDevicePort, 304 ; 
videoFormat, 304 logging 


videoFrameHeight, 304 CHEB OY 1%. — 
videoFrameWidth, 304 in graphical application, 152 


videoMode, 326 P eee wets 
tips for writing, 292 isabling on command line, 275 


updating syntax from earlier version, 279 lop viewen, 147 
Secs preferences, 151 


cropping, 310 
device ID and port, 304 


see also broadcasting 
Linux installation, 28 


loss protection, 82 
lossless audio 


disabling, 325 audience, 138 
filters codec list, 48 
black-level, 314 editing restrictions, 47 


encoding complexity, 79 
encoding modes, 47 
input formats, 46 
output formats, 46 


de-interlace, 312 
inverse-telecine, 312 
noise reduction, 313 


order for using, 308 
overview, 307 overview, 45, 46 


resizing, 314 player and server compatibility, 46 
mode, 326 streaming rates, 47 
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M — media profile in job file, 324 
metafile, 22 
monitors, 144 
multicasting 
advanced settings, 194 
archiving on server, 191 
command-line option, 262 
multicast addresses, 190 
overview, 189 
packet time to live (TTL), 198 
redundant encoders, 191 
server 
destination syntax, 346 
destinations, 192 
password requirement, 191 
ports used, 191 
preparation, 190 
starting and stopping, 193 
stream name, 192 
URLs, 209 
multichannel audio, see discrete multichan- 
nel audio 


namespaces, 285 
O- OpenDML, 71 


outputs 
compared to destinations, 19 
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overview, 184 
password requirement, 186 
redundant encoders, 187 
server 
destination, 187 
destination syntax, 346 
ports used, 186 
preparation, 186 
starting and stopping, 189 
stream name, 188 
URLs, 209 


preferences 


file locations, 149 
temporary directory, 151 


process ID, 276 
pull broadcast 


advantages of, 202 
broadcasting steps, 203 
command-line option, 265 
disadvantages of, 203 
overview, 202 
server 
destination, 205 
destination syntax, 353 
preparation, 204 
starting and stopping, 207 
stream name, 205 
URLs, 210 


editing, 213 

file location preferences, 149 

in graphical application, 87 

in job file, 319 

multiple, 19 

multiple broadcast outputs, 170 
on command line, 261 

overview, 19 


packet time to live, 198 
password-only broadcast 
advanced settings, 194 
advantages of, 184 
archiving on server, 187 
broadcast steps, 185 
command-line option, 262 
disadvantages of, 185 


Q QuickTime input sources, 26 


R .ram extension, 22 
Ram file, 22 
RealAudio 
audio quality and bandwidth, 33 
bandwidth characteristics, 34 
codec selection in audiences, 158 
codecs, 48 
codec flavor, 36 
discrete multichannel 
codec list, 45 
overview, 43 
high response, 38 
lossless, 45 
lossy nature, 33 
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mono music, 38 portable devices, 72 
sampling rates, 36 recommended sizes, 69 
stereo music, 39 editing, 213 
stereo surround encoding complexity, 79 
codec list, 43 overriding on command line, 274 
overview, 41 error correction, 82 
voice, 37 file rolling, 74 
converting to other formats, 50 filters 
editing, 213 black-level correction, 78 
merging clips, 218 de-interlace, 77 
RealVideo soundtracks, 55 inverse-telecine, 76 
sound quality, 33 noise, 75 
with other clips, 35 resize, 75 
RealMedia Editor frame rates 
command-line editor, 220 factors that affect, 58 
graphical application, 213 lowering for slow CPUs, 58 
preferences, 220 overview, 57 
RealNetworks Production Guide, 4 variable nature, 58 


keyframe maximum time 
benefits of lowering, 81 
costs of lowering, 81 
overview, 80 

merging clips, 218 

multiprocessor optimizations, 60 

quality factors, 53 

quality guide, 69 

Scalable Video Technology, 58 


RealPlayer 
broadcast video latency, 167 
clip information display, 93 
extended clip information, 229 
RealVideo codec support, 61 
related info pane sizing, 227 
seeking through image map, 237 

RealPlayer Scripting Guide, 4 


RealVideo 
i soundtracks, 55 
artifacts | 3 
causes of, 59 startup oe - 
reducing, 75 two-pass encoding, 


variable bit rate encoding, 64 
average bit rate, 66 
encoding settings, 66 
for downloads, 65 
for streaming, 65 
maximum bit rate, 66 
quality, 67 

visual clarity 
factors that affect, 59 
overview, 59 

see also video 


bandwidth characteristics, 55 
clip dimensions, 71 
desktop media, 72 
codecs 
in graphical application, 97 
lossy nature, 57 
overriding on command line, 273 
RealVideo 10, 60 
RealVideo 8, 61 
RealVideo 9, 61 
color formats for inputs, 26 
compressed input, 25 
converting to other formats, 25 
dimensions 


different sizes for different bit rates, 73 options, 238 
see also events file 


resize filters, 75 
RMEvents utility, 238 
extracting map or file information, 239 
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see also image maps 
.rmvb extension, 64 
.tpad extension, 331 
.tpjf extension, 291 
.tpsd extension, 345 


sampling rates, 36 
Scalable Video Technology (SVT), 58 
server destination file 
legacy push server, 351 
overview, 345 
pull broadcast, 353 
push server, 346 
template location, 151 
server destinations 
account-based broadcast, 182 
editing, 208 
multicasts, 192 
password-only broadcast, 187 
specifying on command line, 267 
templates, 207 
shielded cables, 49 
SLTA, 169 
SMIL 
broadcasting, 167 
overview, 22 
statistics, 144 
audio bit rate, 146 
frames per second, 146 
preroll, 146 
quality, 146 
total bit rate, 145 
video bit rate, 145 
stereo surround 
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